Attribut global HTMLAttributs globaux

popover

Transforme un élément en fenêtre contextuelle ouverte par un bouton, sans JavaScript.

S’applique à
Tous les éléments HTML
Sur cette page

Exemple

#
HTML
<button popovertarget="menu" type="button">Ouvrir le menu</button>

<div id="menu" popover style="padding: 16px; border-radius: 12px; border: 1px solid #444;">
  <p style="margin: 0 0 8px">Paramètres du compte</p>
  <button popovertarget="menu" popovertargetaction="hide" type="button">Fermer</button>
</div>
Aperçu

Définition et utilisation

#

L’attribut popover rend l’élément masqué par défaut et lui permet d’apparaître au-dessus du reste de la page. Il est ouvert par un bouton doté de l’attribut popovertarget, qui désigne l’id de la fenêtre. Vous n’avez besoin d’aucune ligne de JavaScript pour cela.

Une fenêtre avec la valeur auto se ferme au clic en dehors d’elle et à l’appui sur Échap, et l’ouverture d’une autre fenêtre auto ferme la précédente. La valeur manual exige une fermeture par un bouton ou un script.

Un élément avec popover va dans ce qu’on appelle la couche supérieure, vous n’avez donc pas à lutter avec z-index. C’est une bonne solution pour les menus, les infobulles et les petits panneaux d’options.

Syntaxe

#
Syntaxe
<button popovertarget="id-fenetre">…</button>
<div id="id-fenetre" popover>…</div>

Valeurs

#
  • auto

    ou vide

    Se ferme au clic à côté et avec la touche Échap. L’ouverture d’une autre fenêtre auto ferme celle-ci.
  • manual

    Se ferme uniquement avec un bouton ou un script. Plusieurs fenêtres manual peuvent être ouvertes en même temps.

Compatibilité des navigateurs

#

Nouveau dans les navigateurs · depuis 2024

Fonctionne dans les versions actuelles de tous les grands navigateurs. Les anciennes versions peuvent ne pas le prendre en charge.

  • Chrome
  • Edge
  • Firefox
  • Safari

Bonnes pratiques

#
  • Le bouton qui ouvre la fenêtre définit lui-même les propriétés d’accessibilité, par exemple aria-expanded.
  • Pour les fenêtres qui bloquent le reste de la page, comme les confirmations, un <dialog> ouvert avec la méthode showModal() est préférable.

Entrées associées

#

Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.