<!-- Generado automáticamente por scripts/generate-docs.mjs. No editar a mano. -->
<!-- Fuente: src/app/componentes/radio/page.tsx -->

# Radio

Permite elegir una sola opción de un grupo corto y conocido. Si el grupo supera cinco opciones o el espacio es limitado, prefiere un dropdown.

```tsx
import { Radio, RadioGroup, Label } from "@fluentui/react-components";

<Label>Frecuencia</Label>
<RadioGroup value={value} onChange={(_, data) => setValue(data.value)}>
  <Radio value="diaria" label="Diaria" />
  <Radio value="semanal" label="Semanal" />
  <Radio value="mensual" label="Mensual" />
</RadioGroup>
```

## Default

### Cuándo usar

- Dos a cinco opciones mutuamente excluyentes.
- El usuario necesita comparar las opciones de un vistazo.
- Existe una opción por defecto razonable; márcala como seleccionada al iniciar.

## Orientación

### Vertical u horizontal

Por defecto el grupo se apila en vertical. Usa `layout="horizontal"` cuando hay pocas opciones cortas y el ancho lo permite.

```tsx
<RadioGroup layout="horizontal" value={value} onChange={(_, data) => setValue(data.value)}>
  <Radio value="es" label="Español" />
  <Radio value="en" label="Inglés" />
  <Radio value="pt" label="Portugués" />
</RadioGroup>
```

## Estados

### Deshabilitado

Deshabilita un grupo entero cuando ninguna opción aplica al contexto actual; deshabilita una opción individual cuando solo esa no aplica. Acompaña con un texto que explique por qué.

```tsx
<RadioGroup defaultValue="b" disabled>
  <Radio value="a" label="Opción A" />
  <Radio value="b" label="Opción B" />
</RadioGroup>

<RadioGroup defaultValue="a">
  <Radio value="a" label="Opción A" />
  <Radio value="b" label="Opción B (no disponible)" disabled />
</RadioGroup>
```

## Accesibilidad

### Teclado y roles

- El grupo se renderiza con role="radiogroup" y cada opción con role="radio".
- Tab entra al grupo; las flechas mueven la selección entre opciones.
- Cada grupo necesita una etiqueta visible o aria-labelledby.
- Una opción siempre está marcada para que el lector de pantalla anuncie un estado válido.

## Contenido

### Etiquetas

- Una a cuatro palabras por opción, en sentence case.
- Paraleliza la redacción: todas verbos, o todas sustantivos.
- Si necesitas explicar una opción, añade una línea de ayuda debajo, no dentro del label.

