HTMLElement: Methode hidePopover()

Baseline 2024

Neu verfügbar

Seit April 2024 funktioniert diese Funktion auf aktuellen Geräten und in aktuellen Browserversionen. Auf älteren Geräten oder in älteren Browsern funktioniert sie möglicherweise nicht.

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();
  }
});