Popover
Panel flotante anclado a un disparador, para contenido contextual liviano — un detalle, un formulario corto, un par de acciones. El disparador lleva los atributos ARIA (aria-haspopup, aria-expanded) y abre el panel.
Capas flotantes · 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.
Detalle de la cuenta en un popover
Tu plan Pro se renueva el 3 de septiembre.
Cuándo usarlo
- El contenido depende del elemento que lo abre y conviene mostrarlo al lado.
- Es liviano y no justifica interrumpir con un diálogo.
- Lo que hay debajo sigue siendo útil mientras el panel está abierto.
Cuándo no
- La tarea merece interrumpir y bloquear el fondo →
modal. - Es una lista de acciones sobre un objeto →
menu. - Es sólo una etiqueta que describe el disparador →
tooltip.
Cómo usarlo
- Se ancla al elemento que lo explica y se elige el
placement-*del panel (placement-bottom-start,placement-top…) que no tape lo importante. - Contenido corto: si necesita scroll propio, ya es un
modalo undrawer.
Cómo no usarlo
- No se mete un flujo de varios pasos en un popover.
- No se abre con hover: un panel con controles se abre con un clic.
TaishoDS Core
Necesita el JS del Core: lo engancha por atributos data-ts-*.
Usa la Popover API para mostrar y ocultar; el resto es posicionamiento.
Qué hace: Ancla el panel al disparador con CSS anchor positioning. El disparador sale con aria-expanded="false" y el Core lo mantiene al abrir y cerrar. Los controles (input, select, textarea) de un panel .ts.popover cerrado quedan disabled (marca data-ts-popover-off; no se toca lo que ya estaba deshabilitado) y se restauran al abrir: no viajan en el formulario ni bloquean su validación mientras el panel está cerrado. Esa parte necesita el script del Core; sin él los campos viajan. El valor de un campo se conserva al reabrir.
Limitación
Sin build, desde el CDN: taisho.popover.css, además de taisho.base.css. Con ese archivo alcanza.
Para el funcionamiento general del Core, ver Comportamiento.
Accesibilidad
- El trigger recibe
aria-haspopup="dialog"yaria-expandedautomáticamente; el Core lo emite enfalsey lo sincroniza al abrir y cerrar el panel. - Cerrado, el panel queda oculto (display none, fuera del árbol de accesibilidad) y conserva sus campos: el valor elegido sigue ahí al reabrir. Sus controles quedan
disabledhasta que abre, así que no viajan en el formulario ni bloquean su validación. - Escape cierra el panel; el clic afuera también.
- Top-layer nativo (Popover API) con anchor positioning y flip automático, dir-aware; fallback
fixedpropio sin soporte — ver la arquitectura de overlays del sistema.
Teclado
Además de lo que ya hace el navegador (Tab mueve el foco, Enter activa un botón).
| Tecla | Qué hace |
|---|---|
| Escape | Cierra y devuelve el foco al trigger. |
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.