Saltar al contenido

SegmentedControl

Selector de una opción entre pocas, mutuamente excluyentes. Es un radiogroup: se navega con flechas (la selección sigue al foco) y expone su valor. Ideal para alternar vistas o filtros donde un Select sería excesivo.

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.

Selector de período

html

Cuándo usarlo

  • Alternar entre 2–4 opciones que conviene tener siempre a la vista (vistas, filtros).
  • El cambio se ve al instante y no vale la pena abrir un panel.
  • Se busca que las opciones y la elegida se lean de un golpe.

Cuándo no

  • Son muchas opciones o no entran → select.
  • Las opciones necesitan descripción o van en vertical → radio.
  • Es navegación entre secciones de contenido, no un valor → tabs.

Cómo usarlo

  • Textos cortos y parejos: entran en el mismo ancho sin romperse.
  • Un puñado de opciones como máximo; si hay dudas, ya conviene un select.

Cómo no usarlo

  • No se usa para navegar entre páginas o vistas grandes → tabs.
  • No se meten seis opciones: se aprieta y pierde legibilidad.

Relacionados

RadioSelectTabs

TaishoDS Core

Necesita el JS del Core: lo engancha por atributos data-ts-*.

La selección y la navegación por teclado entre segmentos las lleva el Core.

El Core lo engancha por estos atributos. Van en el marcado; no hace falta inicializar nada.

  • data-ts-segmented
  • data-ts-segmented-option
  • data-ts-value

Qué hace: Selecciona el segmento, mantiene aria-checked y mueve con las flechas entre opciones.

Sin build, desde el CDN: taisho.segmented-control.css, además de taisho.base.css. También se carga:

  • taisho.button.css
  • taisho.spinner.css

Para el funcionamiento general del Core, ver Comportamiento.

Accesibilidad

Implementa el patrón Radio Group de la WAI-ARIA APG.

  • Rol radiogroup con hijos radio: semántica correcta para elegir un valor. Cada radio toma su nombre del texto del segmento.
  • Roving tabindex: sólo el segmento activo entra en el orden de tabulación; las flechas mueven el foco y la selección lo sigue (Home/End van al primero/último).
  • Las opciones deshabilitadas se saltean en la navegación por teclado.
  • Provee un nombre accesible con aria-label o aria-labelledby — el control no dibuja label propio.

Teclado

Además de lo que ya hace el navegador (Tab mueve el foco, Enter activa un botón).

Tecla Qué hace
→←Siguiente y anterior segmento (con vuelta al otro extremo). En una página RTL se invierten: ← avanza y → retrocede.
↓↑Siguiente y anterior segmento, igual que en un grupo de radios nativo; no dependen de la dirección de escritura.
Home/EndPrimer y último segmento habilitado.

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.