Saltar al contenido

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.

html

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-expanded del 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.

Relacionados

AccordionPopover

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-accordion
  • data-ts-accordion-item
  • data-ts-accordion-trigger
  • data-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, sin aria-expanded propio. 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/EspacioAlterna 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.