Instalación
npx logic2b@next add toggle-groupUso
import { ToggleGroup, ToggleGroupItem } from "@/components/ui/toggle-group"
<ToggleGroup type="multiple">
<ToggleGroupItem value="bold" aria-label="Alternar negrita">
<BoldIcon />
</ToggleGroupItem>
</ToggleGroup>
Notas de uso
Construido sobre ToggleGroup de Radix. Las propiedades variant y size del
grupo se comparten con cada ToggleGroupItem mediante el contexto.
Ejemplos
Selección única
Tamaños
Accesibilidad
- Con
type="single", los elementos se comportan como un grupo de opciones y las teclas de flecha desplazan la selección. - Con
type="multiple", cada elemento se alterna de forma independiente y exponearia-pressed. - Tab lleva el foco al grupo y las teclas de flecha lo
desplazan entre sus elementos. Los que solo tienen icono necesitan un
aria-label.
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
<ToggleGroup
type="single"
defaultValue="center"
variant="outline"
size="default"
aria-label="Text alignment"
>
<ToggleGroupItem
value="left"
aria-label="Align left"
>Left</ToggleGroupItem>
<ToggleGroupItem
value="center"
aria-label="Align center"
>Center</ToggleGroupItem>
<ToggleGroupItem
value="right"
aria-label="Align right"
>Right</ToggleGroupItem>
</ToggleGroup>Referencia de API
Generada a partir de las exportaciones públicas de TypeScript en src/ui/toggle-group.tsx. Las descripciones técnicas conservan el texto canónico del código fuente.
ToggleGroup
ComponenteProps: React.ComponentProps<typeof ToggleGroupPrimitive.Root> & VariantProps<typeof toggleVariants>| Propiedad | Tipo | Obligatoria | Valor predeterminado | Descripción |
|---|---|---|---|---|
variant | null | "default" | "outline" | No | — | — |
size | null | "default" | "sm" | "lg" | No | — | — |
ToggleGroupItem
ComponenteProps: React.ComponentProps<typeof ToggleGroupPrimitive.Item> & VariantProps<typeof toggleVariants>| Propiedad | Tipo | Obligatoria | Valor predeterminado | Descripción |
|---|---|---|---|---|
variant | null | "default" | "outline" | No | — | — |
size | null | "default" | "sm" | "lg" | No | — | — |
Contrato de accesibilidad
Comportamiento legible por máquinas y responsabilidades de quien integra toggle-group. Los detalles normativos conservan el texto canónico del registro.
- Soporte
- Gestionado por la primitiva
- Patrón
- toggle group
- Radix Toggle Group
| Teclas | Comportamiento |
|---|---|
| ArrowUp ArrowDown ArrowLeft ArrowRight | Move within the composite control. |
| Enter Space | Activate the focused control. |
Semántica incorporada
- Uses roving focus and pressed/selected state for single or multiple selection.
Responsabilidades de integración
- Label the group and every icon-only item.