Saltar al contenido

Popover API: menús y tooltips sin JavaScript

En la práctica/ 11 min de lectura

La Popover API en la práctica: un menú, un tooltip y un aviso en HTML, cierre al tocar afuera, popover="manual", animación con CSS, foco y soporte.

  • JavaScript
En este artículo (9)
  1. Popover API: popover y popovertarget
  2. Cerrar al tocar afuera y con Escape
  3. popover="manual" para avisos que no se cierran solos
  4. Animarlo con CSS
  5. Accesibilidad y foco
  6. Soporte
  7. Errores comunes
  8. Preguntas frecuentes
  9. Checklist

La Popover API te deja abrir menús, tooltips y avisos sin JavaScript: pones popover en el elemento y popovertarget en el botón. El navegador lo lleva a la capa superior, lo cierra con un clic afuera o con Escape y conecta el botón con el menú para el teclado. Es Baseline desde enero de 2025.

Aquí tienes los tres usos con el código completo: un menú de cuenta, un tooltip que se abre con clic y un aviso que solo se cierra con su botón. Los probamos en Chromium 151, Firefox 155 y WebKit 26.5 con Playwright, y te decimos dónde se comportan distinto.

Popover API: popover y popovertarget

Son dos atributos de HTML. popover convierte un elemento en un popover: queda oculto hasta que algo lo abre. popovertarget, en un <button>, recibe el id del popover y lo abre y cierra con cada clic. Según la documentación de MDN, popovertarget funciona en <button> y en <input> de tipo botón, no en un <div> ni en un enlace. Este es el menú de cuenta de una tienda:

<button type="button" popovertarget="menu">Mi cuenta</button>
<nav id="menu" popover aria-label="Mi cuenta">
  <ul>
    <li><a href="/cuenta/pedidos">Mis pedidos</a></li>
    <li><a href="/cuenta/direcciones">Direcciones</a></li>
    <li><a href="/cuenta/salir">Cerrar sesión</a></li>
  </ul>
</nav>
  1. El <button> lleva popovertarget="menu": cada clic abre o cierra el elemento con ese id. type="button" evita que envíe un formulario si el menú queda dentro de uno.
  2. <nav id="menu" popover> es el popover. Sin valor, popover equivale a popover="auto", el comportamiento de menú.
  3. aria-label le da nombre a la navegación, porque una página puede tener varias.
  4. Dentro van enlaces normales en una lista. No hace falta role="menu": ese rol promete navegación con flechas que tendrías que programar tú.

Al abrirse, el popover sube a la capa superior (top layer), la misma donde viven los modales y la pantalla completa. Queda encima de todo sin z-index. Lo comprobamos poniendo el popover dentro de una caja de 10 px con overflow: hidden y transform, debajo de una capa fija con el z-index máximo: en los tres motores se vio completo y encima.

un botón abre el menú en la capa superiorla páginaMi cuentapopovertarget="menu"el resto del contenidocapa superiorMis pedidosDireccionesCerrar sesiónid="menu" popoverencima de todosin z-index; overflow: hidden no lo recortaEscape o un clic afuera lo cierranun botón, un id, cero JavaScriptfuente: MDN, Popover API y top layer

Desliza la figura para verla completa

Falta la posición. Por defecto el navegador centra el popover en la ventana (position: fixed, inset: 0 y margin: auto), que sirve para un aviso pero no para un menú. Para pegarlo al botón se usa CSS anchor positioning, que coloca un elemento según la posición de otro, su ancla. Con popovertarget no tienes que declarar el ancla: MDN explica que el botón se vuelve el ancla implícita del popover y que position-area la adopta sola.

/* The menu sits under its button (anchor positioning). */
#menu {
  position-area: bottom span-right;
  margin: 0.25rem 0 0;
}
  1. position-area: bottom span-right lo pone debajo del botón, alineado con su borde izquierdo y con espacio hacia la derecha.
  2. margin: 0.25rem 0 0 deja un respiro de 4 px arriba y quita el margin: auto de fábrica, que lo centraría dentro del área.

En las tres pruebas el menú quedó 4 px debajo del botón, con el borde izquierdo alineado. Si el navegador no entiende position-area, el menú sale centrado en la ventana: se ve raro, pero funciona.

los atributos en una tarjetaatributovalorqué hacepopoverautocierra con clic afuera y Escapepopoverhintpara tooltips; en Safari, manualpopovermanualsolo lo cierras túpopovertargetidel botón que lo controlapopovertargetactiontoggle|show|hidetoggle por defecto:popover-opencssestilo cuando está abiertosin soporte de hint, el navegador lo trata como manualatributos de la Popover APIfuente: MDN, atributo popover y Popover API

Desliza la figura para verla completa

Cerrar al tocar afuera y con Escape

Un popover auto se cierra solo de tres formas, y ninguna necesita código. MDN lo llama light dismiss (guía de uso):

  • Un clic o toque afuera lo cierra.
  • Escape lo cierra. MDN lo describe como un mecanismo de cada navegador; en escritorio es la tecla Esc.
  • Abrir otro popover auto cierra el que estaba abierto, salvo que uno esté anidado en el otro, como un submenú.

El segundo clic en el mismo botón también lo cierra, porque popovertarget alterna. Ese comportamiento es el que quieres en un tooltip que se abre con clic o toque (a veces llamado toggletip):

<p>Envío exprés
  <button type="button" popovertarget="ayuda-envio" aria-label="Qué es el envío exprés">?</button>
</p>
<p id="ayuda-envio" popover>Llega en un día hábil dentro de la ciudad.</p>
  1. El botón muestra un ?, así que aria-label le da un nombre que se entienda al oído.
  2. El texto del tooltip es un párrafo con popover: se abre con clic o toque y se cierra afuera o con Escape.
  3. Como es auto, abrirlo cierra el menú si estaba abierto. En las pruebas pasó así en los tres motores.

Sin JavaScript, el tooltip se abre con clic, no al pasar el mouse. Existe un valor pensado para tooltips, popover="hint": no cierra los popovers auto al mostrarse y cierra los otros hint. Pero hoy no está en Safari estable, y un navegador que no lo conoce lo trata como manual; en WebKit 26.5 el atributo se leyó como "manual". Por eso el ejemplo usa auto.

popover="manual" para avisos que no se cierran solos

Un aviso de envíos no debería desaparecer porque alguien tocó la página. Con popover="manual" no hay light dismiss: ni el clic afuera ni Escape lo cierran, puedes tener varios abiertos y no cierra ni lo cierran los popovers auto. Lo cierras tú, con un botón:

<button type="button" popovertarget="aviso" popovertargetaction="show">Ver aviso de envíos</button>
<div id="aviso" popover="manual">
  <p>Los pedidos de hoy salen el lunes.</p>
  <button type="button" popovertarget="aviso" popovertargetaction="hide">Cerrar aviso</button>
</div>
  1. popovertargetaction="show" hace que el primer botón solo abra; un segundo clic no lo cierra. El valor por defecto es toggle.
  2. popover="manual" desactiva el cierre automático.
  3. El botón de dentro apunta al mismo id con popovertargetaction="hide", así que solo cierra.

En las pruebas, el aviso siguió abierto tras un clic afuera, tras Escape y mientras el menú se abría y se cerraba encima. Si el aviso debe aparecer solo al cargar la página, eso sí pide una línea de JavaScript: document.getElementById("aviso").showPopover().

ValorClic afueraEscapeAl abrirsePara qué
auto (o vacío)Lo cierraLo cierraCierra los otros auto no anidadosMenús, tooltips con clic
hintLo cierraLo cierraCierra otros hint, no los autoTooltips; sin Safari estable aún
manualNoNoNo cierra nadaAvisos, toasts
tres usos, tres comportamientos de cierremenúpopover="auto"clic en el botóncierra con clic afueray con Escapeuno abierto a la vezej.: Mi cuentatooltippopoverclic o toque, no hoveruna frase cortacierra como el menúhint: Safari aún noej.: envío exprés ?avisopopover="manual"ignora el clic afueraignora Escapecierra con su botónvarios a la vezej.: salen el lunesauto cierra a los demás auto; manual no entra en la pilatres valores: auto, hint y manualprobado en Chromium 151, Firefox 155 y WebKit 26.5

Desliza la figura para verla completa

Animarlo con CSS

Un popover cerrado tiene display: none, así que una transición normal no se ve. La receta de MDN usa @starting-style para la entrada y transition-behavior: allow-discrete para que display y overlay esperen a que termine la salida:

/* Fade in and out. overlay keeps it in the top layer while it closes. */
[popover] {
  opacity: 0;
  translate: 0 -0.5rem;
  transition:
    opacity 0.15s,
    translate 0.15s,
    overlay 0.15s allow-discrete,
    display 0.15s allow-discrete;
}
[popover]:popover-open {
  opacity: 1;
  translate: 0 0;
}
@starting-style {
  [popover]:popover-open {
    opacity: 0;
    translate: 0 -0.5rem;
  }
}

/* No movement for people who asked for less of it. */
@media (prefers-reduced-motion: reduce) {
  [popover] {
    transition: none;
  }
}
  1. La regla [popover] describe el estado cerrado: transparente y 8 px más arriba.
  2. La lista de transition anima opacidad y desplazamiento; display y overlay llevan allow-discrete para que el popover siga visible y en la capa superior durante la salida.
  3. :popover-open es el estado abierto.
  4. @starting-style da el punto de partida de la entrada. Va después de la regla :popover-open, porque tienen la misma especificidad.
  5. Con prefers-reduced-motion: reduce no hay transición: en las pruebas no quedó ninguna animación.

Lo que medimos: la entrada se animó en los tres motores. La salida solo en Chromium; en Firefox 155 y WebKit 26.5 el popover desapareció de golpe. Cuadra con los datos de compatibilidad de MDN, que dan overlay solo en Chrome y Edge. No se rompe nada, solo se pierde la animación de salida. Si lo que quieres animar es el paso de una página a otra, eso es otra API: View Transitions entre páginas.

Accesibilidad y foco

Según MDN, cuando un botón controla un popover con popovertarget, el navegador crea una relación implícita aria-expanded y aria-details entre los dos, y el popover pasa a ser lo siguiente en el orden de tabulación después del botón. En el árbol de accesibilidad de Chromium el botón apareció con expanded=true mientras el menú estaba abierto. Con el teclado, el recorrido funcionó en los tres motores: Enter en el botón abre el menú, Tab entra al primer elemento y Escape lo cierra y devuelve el foco al botón.

Dos diferencias de WebKit que vale la pena conocer. Primero, Tab no pasó a los enlaces del menú: como Safari por defecto, WebKit solo enfoca con Tab botones y campos, y los enlaces se alcanzan con Opción+Tab; con botones dentro del menú el recorrido fue igual que en los demás. Segundo, un clic con el mouse no enfoca el botón, así que al cerrar con Escape después de abrir con clic el foco quedó en <body>.

Un popover no es modal: no bloquea el resto de la página ni encierra el foco. Si necesitas eso, por ejemplo para confirmar que se vacía el carrito, usa <dialog> con showModal(). Y mostrar un popover no mueve el foco hacia él, así que un aviso que tiene que oírse necesita además una región viva, como un role="status" que ya esté en la página. En formularios, el mismo cuidado con nombres y mensajes está en la guía de formularios accesibles con WCAG 2.2.

Soporte

El popover básico es Baseline desde el 27 de enero de 2025. Un artículo de web.dev de abril de 2024 lo había anunciado antes, y web.dev lo corrigió el 7 de febrero de 2025: en iOS el clic afuera no cerraba el popover hasta Safari 18.3. La página del atributo en MDN todavía muestra la fecha vieja. Lo demás va por partes, según los datos de compatibilidad de MDN y webstatus.dev, consultados el 19 de noviembre de 2026:

PiezaChrome y EdgeFirefoxSafariBaseline
popover, popovertarget, :popover-open11412517 (iOS 18.3)Sí, desde enero de 2025
@starting-style (entrada)11712917.5Sí, desde agosto de 2024
overlay (salida)117NoNoLimitado
popover="hint"151153No en estable (27.3 en beta)Limitado
position-area con ancla implícita13314726Anchor positioning completo: limitado

Sobre la posición: webstatus.dev marca anchor positioning completo como disponibilidad limitada (Chrome y Edge 157, Safari 27; Firefox aún no completo), pero la parte que usa este artículo, position-area con el ancla implícita, está en Firefox desde la 147 y en Safari desde la 26 según MDN, y funcionó en los tres motores de prueba. Donde falte, el menú sale centrado.

Errores comunes

  • Poner popovertarget en un <div> o un enlace. Solo funciona en <button> e <input> de tipo botón.
  • Usar manual para un menú. Pierdes el cierre al tocar afuera y con Escape; tendrías que programarlo.
  • Pelear con z-index. El popover abierto ya está en la capa superior; si queda tapado, probablemente no está abierto como popover.
  • Contar con hint en todos lados. Safari estable no lo tiene y lo trata como manual.
  • Dar por hecha la animación de salida. Solo corre en Chrome y Edge; diseña para que el cierre de golpe también se vea bien.
  • Usar anchor() sin quitar el margen. MDN avisa que el margin: auto de fábrica choca con anchor(); con position-area no pasa, pero igual conviene fijar el margen.
  • Poner role="menu" a una lista de enlaces. Promete flechas que no programaste.
  • Usar un popover como modal. No bloquea la página; para eso está <dialog>.

Preguntas frecuentes

¿Cuándo uso popover y cuándo dialog?

Popover para lo que convive con la página: menús, tooltips, avisos. <dialog> con showModal() cuando la persona debe responder antes de seguir, porque deja el resto de la página inactivo. Se pueden combinar: <dialog popover> es válido y sigue siendo no modal.

¿Puedo abrir el tooltip al pasar el mouse sin JavaScript?

No en todos los navegadores. Hay un atributo nuevo, interestfor, que abre un popover al pasar el mouse o enfocar, pero según webstatus.dev solo está en Chrome y Edge. Hoy, sin JavaScript, el tooltip se abre con clic o toque, que además funciona igual en móvil, donde no hay hover.

¿popovertarget o commandfor?

commandfor con command="toggle-popover" (también show-popover y hide-popover) hace lo mismo y sirve para otras órdenes, como abrir un <dialog>. Es Baseline desde diciembre de 2025 y funcionó en los tres motores de prueba. popovertarget tiene más tiempo en los navegadores; para un popover cualquiera de los dos sirve.

¿Cómo sé cuándo se abre, por ejemplo para analítica?

Con el evento toggle, que trae oldState y newState: menu.addEventListener("toggle", (e) => console.log(e.newState)) registró closed>open y open>closed en las pruebas. Si necesitas impedir que se abra, beforetoggle llega antes y preventDefault() lo detiene.

Checklist

  • El control es un <button type="button"> con popovertarget y el id correcto.
  • Menús y tooltips usan popover (auto); avisos que no deben cerrarse solos usan manual con su botón de cerrar.
  • El tooltip con un ? tiene aria-label.
  • El menú se posiciona con position-area y se ve bien si sale centrado.
  • No hay z-index ni role="menu" de más.
  • La animación usa @starting-style, la salida es una mejora y hay regla para prefers-reduced-motion.
  • Probaste con teclado: Enter abre, Tab entra, Escape cierra y regresa al botón.
  • Lo que debe ser modal usa <dialog>.

¿Viste esto en Instagram? Todas las guías de los Reels están en ecomlabs.dev/guias.

Escrito por

Luis Morales

Luis Morales

Desarrollador frontend y Shopify, EcomLabs

@luismoralesdev en Instagram

Publicado el 19 de noviembre de 2026 · actualizado el 20 de noviembre de 2026

← Blog