Saltar al contenido

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

Ventas del mes y comparación con el anterior.
Últimos movimientos de la cuenta.
Preferencias de notificaciones.
html

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).

Ventas del mes.
Últimos movimientos.
Ventas del mes.
Últimos movimientos.
html

Orientación

horizontal (fila) o vertical (columna al costado).

Ventas del mes.
Últimos movimientos.
Ventas del mes.
Últimos movimientos.
html

Estados

is-active marca la pestaña abierta; disabled la deshabilita.

Ventas del mes.
Últimos movimientos.
Ventas del mes.
Últimos movimientos.
html

Combinaciones

Variante y orientación actuando juntas.

Ventas del mes.
Últimos movimientos.
html

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-bar o sidebar.
  • El contenido conviene leerlo entero y de corrido → accordion o 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.

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-tabs
  • data-ts-tabs-panel
  • data-ts-tabs-tab
  • data-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" con aria-selected y aria-orientation.
  • Cada pestaña lleva id y aria-controls hacia su panel; cada panel lleva aria-labelledby hacia su pestaña, así que el lector lo anuncia con el nombre de la pestaña. El emparejamiento sale de data-ts-value.
  • El Core genera los id que falten al iniciar y respeta los que ya estén escritos, igual que aria-controls, aria-labelledby y tabindex. Una pestaña sin panel no lleva aria-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 con hidden.
  • 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 disabled se saltean.
  • Al cambiar de pestaña el indicador se desliza hasta la nueva con una transición de transform; con prefers-reduced-motion: reduce salta 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/EndPrimera y última pestaña habilitada.
TabSale 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.