Radio
Selección única dentro de un conjunto. Las opciones comparten name y van dentro de un role="radiogroup". Soporta una descripción por opción (has-description) y, en el grupo, label, error y ayuda.
Formularios · TaishoDS Core, en HTML plano.
Ejemplos
Un ejemplo por caso, funcionando. Cada ejemplo es el HTML de su vista previa: se copia tal cual y, con el CSS y el JS del Core cargados, se ve y funciona igual.
Grupo de planes
Entornos con descripción
Opciones en tarjeta
Obligatorio con error
Referencia de clases
Todos los valores de cada modificador, con su HTML listo para copiar.
Tamaño
El tamaño del control: sm, md o lg.
Variante
El color cuando está elegido: primary por defecto, que toma el primario del tema (primary; si no se define, la marca), o el semántico.
Densidad
El aire alrededor del control y su etiqueta.
Combinaciones
Tamaño y color actuando juntos.
Cuándo usarlo
- Elegir exactamente una de pocas opciones que conviene ver todas a la vez.
- Las opciones necesitan una descripción o más contexto (
has-description). - Se busca que comparar entre opciones sea visible sin abrir nada.
Cuándo no
- Son 2–4 opciones para alternar una vista o filtro →
segmented-control. - Las opciones son muchas y no entran cómodas →
select. - Se pueden elegir varias →
checkbox.
Cómo usarlo
- Las opciones van siempre dentro de un
role="radiogroup", con una marcada por defecto. - El grupo lleva un nombre (
aria-label): es lo que nombra la pregunta (“Entorno”). Dentro del HTML defield, el nombre lo pone elfield. - El error se muestra una vez en el grupo, no en cada opción.
- Las opciones se ordenan con lógica (frecuencia, magnitud).
Cómo no usarlo
- No se usa para una sola opción de sí/no →
checkbox. - No se usa para listas largas: se vuelve una pared de opciones →
select.
Relacionados
TaishoDS Core
Necesita el JS del Core: lo engancha por atributos data-ts-*.
Es un <input type="radio"> nativo; la agrupación la hace name. Para pintar el estado, el Core refleja checked en la clase is-checked de la etiqueta (y apaga la del resto del grupo); el label, el error, la ayuda y la descripción son marcado que ya trae el ejemplo.
Qué hace: Al cambiar la selección, refleja checked en la clase is-checked de la etiqueta y apaga la de los demás radios con el mismo name dentro del mismo formulario (o del mismo contenedor, si no hay formulario). El teclado, el foco y el envío son los del navegador.
Sin build, desde el CDN: taisho.radio.css, además de taisho.base.css. También se carga:
taisho.icon.css
Para el funcionamiento general del Core, ver Comportamiento.
Accesibilidad
Implementa el patrón Radio Group de la WAI-ARIA APG.
- Se apoya en
<input type="radio">nativo connamecompartido: las flechas mueven la selección dentro del grupo. - Si la elección es obligatoria, cada
<input type="radio">llevarequiredy el contenedorrole="radiogroup"marcaaria-required="true". - El grupo se nombra con
aria-labelledbyal texto visible; el texto de ayuda y el mensaje de error lo describen conaria-describedbyy el error agregaaria-invalid="true"(anunciado conaria-live="polite").
Teclado
Además de lo que ya hace el navegador (Tab mueve el foco, Enter activa un botón).
| Tecla | Qué hace |
|---|---|
| ↑↓←→ | Mueve la selección entre las opciones del grupo. |
Verificación
Qué se probó de verdad. Lo que no se probó lo dice: preferimos un «sin verificar» a una afirmación de más.
- axe WCAG 2.2 A + AA en navegador real, en tema claro y oscuro, antes de cada versión.
- teclado Mapa de teclas documentado arriba, contrastado contra el componente.
- lector de pantalla Sin verificar con lector de pantalla. Conviene probarlo en la combinación de componentes propia, no sólo aquí, donde cada uno aparece solo y en su estado feliz.