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?
¿Cómo invito a alguien?
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
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-accordiondata-ts-accordion-itemdata-ts-accordion-triggerdata-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.csstaisho.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, sinaria-expandedpropio. - 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/Espacio | Abre 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.