HTMLElement: Methode hidePopover()

Baseline 2025

Newly available

Since January 2025, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

Die hidePopover()-Methode des HTMLElement-Interfaces verbirgt ein Popover-Element (d.h. eines, das ein gültiges popover-Attribut hat), indem es aus der Top-Ebene entfernt und mit display: none gestylt wird.

Wenn hidePopover() bei einem sichtbaren Element mit dem popover-Attribut aufgerufen wird, wird ein beforetoggle-Ereignis ausgelöst, gefolgt davon, dass das Popover verborgen wird, und dann das toggle-Ereignis ausgelöst. Wenn das Element bereits verborgen ist, wird ein Fehler ausgelöst.

Syntax

hidePopover()

InvalidStateError DOMException: Wird ausgelöst, wenn das Popover bereits verborgen ist.

Beispiele

Das folgende Beispiel bietet eine Funktionalität, um ein Popover durch das Drücken einer bestimmten Taste auf der Tastatur zu verbergen.

HTML

html

<button popovertarget="mypopover">Toggle popover's display</button>
<div id="mypopover" popover="manual">
  You can press <kbd>h</kbd> on your keyboard to close the popover.
</div>

JavaScript

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

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

Ergebnis

Spezifikationen

Specification
HTML # dom-hidepopover

Browser-Kompatibilität

Siehe auch

Popover API