Collapsible
Muestra u oculta un bloque de contenido con una transición de altura. A diferencia del Accordion es independiente: una sola sección, sin coordinación con otras. El disparador se puede personalizar.
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.
Detalles de un despliegue
Detalles del despliegue
Construido en 2 min 14 s desde la rama principal.
Cuándo usarlo
- Hay un detalle secundario que la mayoría no necesita ver: opciones avanzadas, un log.
- Es una sola sección y no tiene hermanos con los que coordinarse.
- Se busca controlar la apertura desde afuera: se cambia el
aria-expandeddel disparador.
Cuándo no
- Son varias secciones hermanas que se leen de a una →
accordion. - El contenido es contextual y flotante →
popover.
Cómo usarlo
- Que el disparador diga qué se va a mostrar, no sólo “Ver más”.
- Queda abierto por defecto si el contenido importa en la mayoría de los casos.
Cómo no usarlo
- No se esconde ahí un error o algo que requiere acción.
- No se usa para una lista de secciones: para eso está
accordion.
TaishoDS Core
Necesita el JS del Core: lo engancha por atributos data-ts-*.
Es un <details> con su <summary>: abre y cierra sin JavaScript. El Core sólo suma 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 abre y cierra solo, con clic y con Enter o Espacio. Con el Core emite ts:change (cancelable). Se abre desde código cambiando la propiedad open del <details>, igual que Accordion.
Sin build, desde el CDN: taisho.collapsible.css, además de taisho.base.css. También se carga:
taisho.icon.css
Para el funcionamiento general del Core, ver Comportamiento.
Accesibilidad
Implementa el patrón Disclosure de la WAI-ARIA APG.
- Es un
<details>con su<summary>: el navegador lo expone como botón expandible y publica el estado, sinaria-expandedpropio. Abre y cierra con Enter/Espacio aunque el JavaScript no cargue.
Teclado
Además de lo que ya hace el navegador (Tab mueve el foco, Enter activa un botón).
| Tecla | Qué hace |
|---|---|
| Enter/Espacio | Alterna el contenido. |
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.