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 une fenêtre contextuelle (c'est-à-dire un élément possédant un attribut popover valide) en le retirant de la couche supérieure et en lui appliquant le style display: none.
Lorsque hidePopover() est appelée sur un élément affiché avec l'attribut popover, un évènement beforetoggle est déclenché, suivi du masquage de la fenêtre contextuelle (popover en anglais), puis de l'évènement toggle. Si l'élément est déjà masqué, une erreur est levée.
Syntaxe
hidePopover()
Paramètres
Aucun.
Valeur de retour
Aucune (undefined).
Exceptions
InvalidStateErrorDOMException-
Lancée si la fenêtre contextuelle est déjà masquée.
Exemples
Masquer une fenêtre contextuelle
L'exemple suivant définit un comportement pour masquer une fenêtre contextuelle en appuyant sur une touche particulière du clavier.
HTML
<button popovertarget="mypopover">
Basculer l'affichage de la fenêtre contextuelle
</button>
<div id="mypopover" popover="manual">
Vous pouvez appuyer sur la touche <kbd>h</kbd> de votre clavier pour fermer la
fenêtre contextuelle.
</div>
JavaScript
const popover = document.getElementById("mypopover");
document.addEventListener("keydown", (event) => {
if (event.key === "h") {
popover.hidePopover();
}
});
Résultat
Spécifications
| Specification |
|---|
| HTML # dom-hidepopover |