HTMLElement: popover-Eigenschaft

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.

* Some parts of this feature may have varying levels of support.

Die popover-Eigenschaft des HTMLElement-Interfaces ruft den Popover-Status eines Elements ab und legt ihn über JavaScript fest ("auto" oder "manual"), und kann zur Funktionsdetektion verwendet werden.

Sie spiegelt den Wert des globalen HTML-Attributs popover wider.

Wert

Ein enumerierter Wert; mögliche Werte sind:

  • "auto": Im Auto-Zustand:
    • Das Popover kann "leicht verworfen" werden — dies bedeutet, dass Sie das Popover ausblenden können, indem Sie außerhalb davon klicken oder die Esc-Taste drücken.
    • Normalerweise kann nur ein Popover gleichzeitig angezeigt werden — das Anzeigen eines zweiten Popovers, wenn bereits eines angezeigt wird, blendet das erste aus. Die Ausnahme von dieser Regel ist, wenn Sie verschachtelte Auto-Popover haben. Siehe Verschachtelte Popovers für mehr Details.
  • "manual": Im manuellen Zustand:
    • Das Popover kann nicht "leicht verworfen" werden, obwohl deklarative Schaltflächen zum Anzeigen/Ausblenden/Umschalten weiterhin funktionieren.
    • Mehrere unabhängige Popovers können gleichzeitig angezeigt werden.

Beispiele

Funktionsdetektion

Sie können das popover-Attribut verwenden, um die Popover API zu erkennen:

js
function supportsPopover() {
  return HTMLElement.prototype.hasOwnProperty("popover");
}

Einrichten eines Popovers programmgesteuert

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

const popoverSupported = supportsPopover();

if (popoverSupported) {
  popover.popover = "auto";
  toggleBtn.popoverTargetElement = popover;
  toggleBtn.popoverTargetAction = "toggle";
} else {
  console.log("Popover API not supported.");
}

Spezifikationen

Specification
HTML
# dom-popover

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
popover
hint value
Experimental

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
Partial support
Partial support
In development. Supported in a pre-release version.
In development. Supported in a pre-release version.
No support
No support
Experimental. Expect behavior to change in the future.
Has more compatibility info.

Siehe auch