Saltar al contenido

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

html

Entornos con descripción

Entorno
html

Opciones en tarjeta

Facturación
html

Obligatorio con error

Tu plan
html

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.

html

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.

html

Densidad

El aire alrededor del control y su etiqueta.

html

Combinaciones

Tamaño y color actuando juntos.

html

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 de field, el nombre lo pone el field.
  • 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.

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 con name compartido: las flechas mueven la selección dentro del grupo.
  • Si la elección es obligatoria, cada <input type="radio"> lleva required y el contenedor role="radiogroup" marca aria-required="true".
  • El grupo se nombra con aria-labelledby al texto visible; el texto de ayuda y el mensaje de error lo describen con aria-describedby y el error agrega aria-invalid="true" (anunciado con aria-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.