Tabs
Alterna entre vistas relacionadas dentro del mismo contexto. Expone el valor seleccionado: cada solapa declara el suyo (data-ts-value) y se muestra el panel que le corresponde. Tiene variantes y orientación vertical (orientation-vertical).
Navegación · 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.
Pestañas con tres paneles
Referencia de clases
Todos los valores de cada modificador, con su HTML listo para copiar.
Variante
El estilo de las pestañas: default (subrayado) o secondary (píldoras).
Orientación
horizontal (fila) o vertical (columna al costado).
Estados
is-active marca la pestaña abierta; disabled la deshabilita.
Combinaciones
Variante y orientación actuando juntas.
Cuándo usarlo
- Son vistas alternativas del mismo objeto: detalle, actividad, configuración.
- Sólo una tiene sentido a la vez y cambiar es barato.
- El usuario no necesita comparar dos vistas al mismo tiempo.
Cuándo no
- Es un valor de un formulario, no una vista →
segmented-control. - Son páginas distintas con URL propia →
nav-barosidebar. - El contenido conviene leerlo entero y de corrido →
accordiono secciones planas.
Cómo usarlo
- Etiquetas cortas que digan qué hay adentro.
- Pocas solapas: si no entran en una línea, no es el componente.
Cómo no usarlo
- No se esconde en una solapa algo que el usuario necesita ver siempre.
- No se usan para pasos de un proceso: eso tiene orden, las solapas no.
Relacionados
TaishoDS Core
Necesita el JS del Core: lo engancha por atributos data-ts-*.
El panel activo lo cambia el Core; el marcado ya trae role="tab".
El Core lo engancha por estos atributos. Van en el marcado; no hace falta inicializar nada.
data-ts-tabsdata-ts-tabs-paneldata-ts-tabs-tabdata-ts-value
Qué hace: Cambia el panel activo y mantiene aria-selected y tabindex. Las flechas ← y → mueven entre pestañas (patrón de la APG).
Sin build, desde el CDN: taisho.tabs.css, además de taisho.base.css. También se carga:
taisho.badge.css
Para el funcionamiento general del Core, ver Comportamiento.
Accesibilidad
Implementa el patrón Tabs de la WAI-ARIA APG.
- Patrón
role="tablist"/role="tab"/role="tabpanel"conaria-selectedyaria-orientation. - Cada pestaña lleva
idyaria-controlshacia su panel; cada panel llevaaria-labelledbyhacia su pestaña, así que el lector lo anuncia con el nombre de la pestaña. El emparejamiento sale dedata-ts-value. - El Core genera los
idque falten al iniciar y respeta los que ya estén escritos, igual quearia-controls,aria-labelledbyytabindex. Una pestaña sin panel no llevaaria-controls, para no apuntar a la nada. - El panel es parada de Tab (
tabindex="0"): el contenido sin elementos enfocables también se alcanza por teclado. Los paneles inactivos van conhidden. - Roving tabindex: la pestaña activa es la única en el orden de tabulación. Las flechas del eje del tablist cambian de pestaña y la selección sigue al foco; las pestañas
disabledse saltean. - Al cambiar de pestaña el indicador se desliza hasta la nueva con una transición de
transform; conprefers-reduced-motion: reducesalta sin animar.
Teclado
Además de lo que ya hace el navegador (Tab mueve el foco, Enter activa un botón).
| Tecla | Qué hace |
|---|---|
| →← | En un tablist horizontal (orientation-horizontal) cambian a la pestaña siguiente y a la anterior, con vuelta al otro extremo. En una página RTL se invierten: ← avanza y → retrocede. En el tablist vertical no hacen nada. |
| ↓↑ | En un tablist vertical (orientation-vertical, que expone aria-orientation="vertical") cambian a la pestaña siguiente y a la anterior. En el horizontal no hacen nada y la página sigue desplazándose. |
| Home/End | Primera y última pestaña habilitada. |
| Tab | Sale del tablist: la pestaña activa es el único tab-stop y el siguiente es el panel (tabindex="0"). |
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.