Saltar al contenido

Accordion

Lista de secciones colapsables coordinadas entre sí. Por defecto se abre una sola a la vez; con data-ts-multiple se pueden abrir varias. Cada ítem (data-ts-accordion-item) declara su data-ts-value.

Contenido · 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.

Preguntas frecuentes con un panel abierto

¿Qué incluye el plan Pro?
Despliegues ilimitados para tu equipo.
¿Cómo invito a alguien?
Desde Miembros, con el rol Admin, Editor o Lector.
html

Cuándo usarlo

  • Hay varias secciones hermanas y se leen de a una: preguntas frecuentes, especificaciones.
  • Mostrarlas todas abiertas haría la página inabarcable.
  • Conviene que abrir una cierre la anterior para mantener el foco.

Cuándo no

  • Es una sola sección que se abre y cierra sola → collapsible.
  • Son vistas alternativas del mismo objeto → tabs.
  • El contenido hay que leerlo entero y en orden: debe quedar visible.

Cómo usarlo

  • Títulos que digan qué hay adentro: son lo único visible cuando está cerrado.
  • La primera sección queda abierta si hay una que casi todos van a abrir.

Cómo no usarlo

  • No se esconde ahí información esencial: lo colapsado se lee mucho menos.
  • No se anidan acordeones.

Relacionados

CollapsibleTabs

TaishoDS Core

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

Cada ítem es un <details> con su <summary>, así que abrir y cerrar lo hace el navegador, con clic y con teclado, aunque el JavaScript no cargue. Lo que pide el Core es lo demás: que abrir uno cierre los otros, el evento y abrir desde código.

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

  • data-ts-accordion
  • data-ts-accordion-item
  • data-ts-accordion-trigger
  • data-ts-value

Qué hace: Sin JavaScript, cada ítem abre y cierra solo (Enter y Espacio sobre el <summary>) y se pueden abrir varios a la vez. Con el Core, sin data-ts-multiple abrir uno cierra el otro, y cada cambio emite ts:change (cancelable). Para abrir o cerrar desde código, se cambia la propiedad open del <details>: el Core lo sigue y ese cambio no emite ts:change. Un ítem deshabilitado lleva aria-disabled="true" en el <summary>; sin JavaScript sigue abriéndose.

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

  • taisho.collapsible.css
  • taisho.icon.css

Para el funcionamiento general del Core, ver Comportamiento.

Accesibilidad

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

  • Cada ítem es un <details> y su trigger un <summary>: el navegador lo expone como botón expandible y publica el estado abierto o cerrado, sin aria-expanded propio.
  • Funciona igual sin JavaScript: Enter y Espacio abren y cierran el ítem enfocado.

Teclado

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

Tecla Qué hace
Enter/EspacioAbre o cierra la sección enfocada.

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.