Saltar al contenido
Logic2BUI

Buscar en la documentación

Busca componentes y documentación

Nuevo
Menú

Grupo de opciones

Conjunto de botones seleccionables en el que solo puede estar marcada una opción a la vez.

Instalación

npx logic2b@next add radio-group

Uso

import { RadioGroup, RadioGroupItem } from "@/components/ui/radio-group"

<RadioGroup defaultValue="comfortable">
  <RadioGroupItem value="default" id="r1" />
  <RadioGroupItem value="comfortable" id="r2" />
</RadioGroup>

Ejemplos

Tarjetas

Con una opción desactivada

Accesibilidad

Está construido sobre Radio Group de Radix y sigue el patrón WAI-ARIA radiogroup.

  • Las flechas mueven y seleccionan opciones; solo un elemento puede estar marcado a la vez.
  • Se llega al grupo con Tab; el foco cae sobre la opción marcada o sobre la primera si no hay ninguna seleccionada.
  • Asocia cada RadioGroupItem con un Label mediante valores coincidentes de id y htmlFor para que el área interactiva y el nombre accesible sean correctos.

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
<RadioGroup
  defaultValue="team"
  aria-label="Workspace plan"
>
  <label
    htmlFor="plan-starter"
    className="flex items-center gap-2 text-sm"
  >
    <RadioGroupItem
      id="plan-starter"
      value="starter"
     />
    <span>Starter</span>
  </label>
  <label
    htmlFor="plan-team"
    className="flex items-center gap-2 text-sm"
  >
    <RadioGroupItem
      id="plan-team"
      value="team"
     />
    <span>Team</span>
  </label>
  <label
    htmlFor="plan-enterprise"
    className="flex items-center gap-2 text-sm"
  >
    <RadioGroupItem
      id="plan-enterprise"
      value="enterprise"
     />
    <span>Enterprise</span>
  </label>
</RadioGroup>

Referencia de API

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

Ver JSON

RadioGroup

Componente
Props: React.ComponentProps<typeof RadioGroupPrimitive.Root>

RadioGroupItem

Componente
Props: React.ComponentProps<typeof RadioGroupPrimitive.Item>

Contrato de accesibilidad

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

Ver JSON
Soporte
Gestionado por la primitiva
Patrón
radio group
Radix Radio Group
Interacciones de teclado para radio-group
TeclasComportamiento
ArrowUp ArrowDown ArrowLeft ArrowRightMove within the composite control.
SpaceSelect the focused option.

Semántica incorporada

  • Manages radiogroup/radio roles, aria-checked and roving tab focus.

Responsabilidades de integración

  • Give the group an accessible name and label every option.