Saltar al contenido

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

html

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 modal o un drawer.

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.

Relacionados

ModalMenuTooltip

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

El panel se ancla con CSS anchor positioning y el Core no lo reposiciona. En un navegador sin anchor positioning aparece sin ubicar junto al disparador. Si hace falta posicionamiento por JavaScript, se usa Tooltip.

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" y aria-expanded automáticamente; el Core lo emite en false y 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 disabled hasta 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 fixed propio 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
EscapeCierra 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.