Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

HTMLElement : méthode hidePopover()

Baseline 2024
Newly available

Depuis ⁨April 2024⁩, cette fonctionnalité fonctionne sur les appareils et les versions de navigateur les plus récents. Elle peut ne pas fonctionner sur les appareils ou navigateurs plus anciens.

La méthode hidePopover() de l'interface HTMLElement masque un élément popover (c'est-à-dire un élément qui a un attribut popover valide) en le supprimant de la couche supérieure et en le stylisant avec display: none.

Lorsque hidePopover() est appelée sur un élément affiché avec l'attribut popover :

  1. Un évènement beforetoggle est déclenché.
  2. Le popover est masqué.
  3. L'évènement toggle est déclenché.

Si l'élément est déjà masqué, une erreur est lancée.

Syntaxe

js
hidePopover()

Paramètres

Aucun.

Valeur de retour

Aucune (undefined).

Exceptions

InvalidStateError DOMException

Lancée si le popover est déjà masqué.

Exemples

L'exemple suivant définit un comportement pour masquer un popover en appuyant sur une touche particulière du clavier.

HTML

html
<button popovertarget="mypopover">Basculer l'affichage du popover</button>
<div id="mypopover" popover="manual">
  Vous pouvez appuyer sur la touche <kbd>h</kbd> de votre clavier pour fermer le
  popover.
</div>

JavaScript

js
const popover = document.getElementById("mypopover");

document.addEventListener("keydown", (event) => {
  if (event.key === "h") {
    popover.hidePopover();
  }
});

Résultat

Spécifications

Specification
HTML
# dom-hidepopover

Compatibilité des navigateurs

Voir aussi