Botón de alternancia

import { ItalicIcon } from "lucide-react"

import { Toggle } from "@/components/ui/toggle"

export default function ToggleDemo() {
  return (
    <Toggle aria-label="Toggle italic">
      <ItalicIcon />
    </Toggle>
  )
}

Instalación

npx logic2b@next add toggle

¿Trabajas con un asistente de IA? Copia este prompt en Claude Code, Cursor o Copilot: incluye los pasos de instalación, una alternativa sin CLI y una lista de verificación.

Add the "toggle" item from the logic2b ui registry (https://ui.logic2b.com) to this project. Follow every step and verify at the end.

## Steps

1. If the project has no `components.json` yet, set up logic2b ui first:

   ```bash
   npx logic2b@next init
   ```

2. Install the item (the CLI resolves registry dependencies automatically):

   ```bash
   npx logic2b@next add toggle
   ```

3. Install any npm dependencies the command prints.

## If the CLI is not available

Do it manually from the registry payload:

1. Fetch https://ui.logic2b.com/r/toggle.json.
2. Write every entry in `files[]` to its mapped project path (see below).
3. Repeat (recursively) for each name in `registryDependencies`.
4. Install every package listed in `dependencies` across those payloads.

## Registry reference

- Index of every item: https://ui.logic2b.com/r/index.json
- Item payload (full source): https://ui.logic2b.com/r/<name>.json
- Usage examples per item: https://ui.logic2b.com/r/demos/index.json → https://ui.logic2b.com/r/demos/<demo>.json
- Docs index for agents: https://ui.logic2b.com/llms.txt (full docs: https://ui.logic2b.com/llms-full.txt)
- Every docs page is Markdown when you append `.md` to its URL.

Registry file paths map to project paths like this:
- `ui/*` → `@/components/ui/*`
- `blocks/<name>/*` → `@/components/*`
- `charts/*` → `@/components/charts/*`
- `hooks/*` → `@/hooks/*`
- `lib/utils.ts` → `@/lib/utils.ts`
- `theme.css` → next to the project's Tailwind entry stylesheet

## Conventions (do not break these)

- Tailwind CSS v4 (CSS-first config; no tailwind.config.js needed) and React 19.
- All colors go through semantic tokens (`bg-primary`, `text-muted-foreground`,
  `border-border`, …). Never hardcode hex/oklch values in components.
- Dark mode is class-based: toggle `.dark` on `<html>`.
- Icons come from lucide-react.

## Verify before finishing

1. The dev server starts and the app renders without console errors.
2. TypeScript compiles (`tsc --noEmit` or the framework's check).
3. Components use the theme: a `<Button>` shows the primary token color,
   and toggling `.dark` on `<html>` switches the palette.

Instala las dependencias:

npm install radix-ui class-variance-authority

Copia el contenido en ui/toggle.tsx:

import * as React from "react"
import { Toggle as TogglePrimitive } from "radix-ui"
import { cva, type VariantProps } from "class-variance-authority"

import { cn } from "@/lib/utils"

const toggleVariants = cva(
  "inline-flex items-center justify-center gap-2 rounded-md text-sm font-medium hover:bg-muted hover:text-muted-foreground disabled:pointer-events-none disabled:opacity-50 data-[state=on]:bg-accent data-[state=on]:text-accent-foreground [&_svg]:pointer-events-none [&_svg:not([class*='size-'])]:size-4 [&_svg]:shrink-0 focus-visible:border-ring focus-visible:ring-ring/50 focus-visible:ring-[3px] outline-none transition-[color,box-shadow]",
  {
    variants: {
      variant: {
        default: "bg-transparent",
        outline:
          "border border-input bg-transparent shadow-xs hover:bg-accent hover:text-accent-foreground",
      },
      size: {
        default: "h-9 px-2 min-w-9",
        sm: "h-8 px-1.5 min-w-8",
        lg: "h-10 px-2.5 min-w-10",
      },
    },
    defaultVariants: {
      variant: "default",
      size: "default",
    },
  }
)

function Toggle({
  className,
  variant,
  size,
  ...props
}: React.ComponentProps<typeof TogglePrimitive.Root> &
  VariantProps<typeof toggleVariants>) {
  return (
    <TogglePrimitive.Root
      data-slot="toggle"
      className={cn(toggleVariants({ variant, size, className }))}
      {...props}
    />
  )
}

export { Toggle, toggleVariants }

Uso

import { Toggle } from "@/components/ui/toggle"

<Toggle aria-label="Alternar cursiva">
  <ItalicIcon />
</Toggle>

Notas de uso

Construido sobre Toggle.Root de Radix con variantes de cva.

Ejemplos

Contorno

import { ItalicIcon } from "lucide-react"

import { Toggle } from "@/components/ui/toggle"

export default function ToggleOutlineDemo() {
  return (
    <Toggle variant="outline" aria-label="Toggle italic">
      <ItalicIcon />
    </Toggle>
  )
}

Con texto

import { BoldIcon } from "lucide-react"

import { Toggle } from "@/components/ui/toggle"

export default function ToggleTextDemo() {
  return (
    <Toggle aria-label="Toggle bold" className="px-3">
      <BoldIcon />
      Bold
    </Toggle>
  )
}

Tamaños

import { StarIcon } from "lucide-react"

import { Toggle } from "@/components/ui/toggle"

export default function ToggleSizesDemo() {
  return (
    <div className="flex items-center gap-2">
      <Toggle size="sm" variant="outline" aria-label="Favorite, small">
        <StarIcon />
      </Toggle>
      <Toggle size="default" variant="outline" aria-label="Favorite, default">
        <StarIcon />
      </Toggle>
      <Toggle size="lg" variant="outline" aria-label="Favorite, large">
        <StarIcon />
      </Toggle>
    </div>
  )
}

Accesibilidad

Expone aria-pressed para que se anuncie su estado activado o desactivado.
Se alterna con Espacio o Intro cuando tiene el foco y se alcanza con Tab.
Los botones que solo muestran un icono necesitan un aria-label como nombre accesible.

Playground interactivo

Edita las propiedades del componente y revisa el JSX exacto antes de copiarlo. La vista previa se carga solo cuando esta sección entra en pantalla.

JSX generado

<Toggle
  variant="default"
  size="default"
>Bold</Toggle>

Referencia de API

Generada a partir de las exportaciones públicas de TypeScript en src/ui/toggle.tsx. Las descripciones técnicas conservan el texto canónico del código fuente.

Ver JSON

Toggle

Componente

Props: React.ComponentProps<typeof TogglePrimitive.Root> & VariantProps<typeof toggleVariants>

Propiedad	Tipo	Obligatoria	Valor predeterminado	Descripción
`variant`	`null \| "default" \| "outline"`	No	—	—
`size`	`null \| "default" \| "sm" \| "lg"`	No	—	—

toggleVariants

Utilidad

(props?: (ConfigVariants<{ variant: { default: string; outline: string; }; size: { default: string; sm: string; lg: string; }; }> & ClassProp) | undefined): string

Contrato de accesibilidad

Comportamiento legible por máquinas y responsabilidades de quien integra toggle. Los detalles normativos conservan el texto canónico del registro.

Ver JSON

Soporte: Gestionado por la primitiva
Patrón: toggle button; Radix Toggle

Interacciones de teclado para toggle
Teclas	Comportamiento
`Enter` `Space`	Activate the focused control.

Semántica incorporada

Exposes pressed state through aria-pressed.

Responsabilidades de integración

Icon-only toggles require an aria-label describing the action.