HTML popover globales Attribut
Baseline 2024 *Newly available
Since April 2024, 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.
Das popover
globale Attribut wird verwendet, um ein Element als Popover-Element zu kennzeichnen.
Wert
Das popover
-Attribut kann einen der folgenden Werte annehmen:
"auto"
-
auto
Popover können "leicht verworfen" werden – das bedeutet, dass Sie das Popover verbergen können, indem Sie außerhalb davon klicken oder die Esc-Taste drücken. Das Anzeigen einesauto
Popovers wird in der Regel andereauto
Popovers schließen, die bereits angezeigt werden, es sei denn, sie sind verschachtelt.Hinweis: Das Setzen eines leeren Werts für
popover
—popover
oderpopover=""
— ist gleichbedeutend mit dem Setzen vonpopover="auto"
. "hint"
Experimentell-
hint
Popovers schließen keineauto
Popovers, wenn sie angezeigt werden, schließen aber andere Hint Popovers. Sie können leicht verworfen werden und reagieren auf Schließungsanfragen. "manual"
-
manual
Popovers können nicht "leicht verworfen" werden und werden nicht automatisch geschlossen. Popovers müssen explizit mit deklarativen Anzeigen/Verbergen/Umschalt-Schaltflächen oder JavaScript angezeigt und geschlossen werden. Mehrere unabhängigemanual
Popovers können gleichzeitig angezeigt werden.
Beschreibung
Popover-Elemente sind über display: none
versteckt, bis sie über ein aufrufendes/steuerndes Element (d.h. ein <button>
oder <input type="button">
mit einem popovertarget
Attribut) oder einen HTMLElement.showPopover()
Aufruf geöffnet werden.
Wenn geöffnet, erscheinen Popover-Elemente über allen anderen Elementen in der obersten Ebene und werden nicht von den position
oder overflow
Stileigenschaften der Elternelemente beeinflusst.
Popover, die den auto
Zustand haben, können über zugeordnete Steuerelemente (angegeben durch das popovertarget
Attribut) ein- und ausgeblendet und durch Klicken außerhalb des Popover-Bereichs, das Öffnen eines anderen Popovers oder Drücken von browserspezifischen Mechanismen wie der Esc-Taste "leicht verworfen" werden.
In der Regel kann nur ein auto
Popover gleichzeitig auf dem Bildschirm angezeigt werden – das Anzeigen eines zweiten Popovers, wenn bereits eins angezeigt wird, blendet das erste aus. Die Ausnahme zu dieser Regel ist, wenn Sie verschachtelte auto Popovers haben. Weitere Details finden Sie unter Verschachtelte Popovers.
Sie können auch mit JavaScript gesteuert werden, zum Beispiel kann die HTMLElement.togglePopover()
Methode verwendet werden, um ein Popover zwischen angezeigt und verborgen umzuschalten.
Im Gegensatz dazu müssen manual
Popovers manuell ein- und ausgeblendet werden — sie schließen nicht automatisch andere Popovers, wenn sie angezeigt werden, und können nicht leicht verworfen werden. Dies erlaubt Anwendungsfälle, bei denen Sie mehrere Popovers gleichzeitig anzeigen möchten.
hint
Popovers schließen keine auto
Popovers, wenn sie angezeigt werden, schließen aber andere Hint Popovers. Sie können leicht verworfen werden und reagieren auf Schließungsanfragen.
In der Regel werden hint
Popovers als Reaktion auf nicht-klickende JavaScript-Ereignisse wie mouseover
/mouseout
und focus
/blur
ein- und ausgeblendet. Das Klicken auf eine Schaltfläche zum Öffnen eines hint
Popovers würde dazu führen, dass ein geöffnetes auto
Popover leicht verworfen wird.
Für detaillierte Informationen zur Nutzung siehe die Popover API Startseite.
Beispiele
Das Folgende rendert eine Schaltfläche, die ein Popover-Element öffnet, wenn sie aktiviert wird.
<button popovertarget="my-popover">Open Popover</button>
<div popover id="my-popover">Greetings, one and all!</div>
Hinweis: Sehen Sie sich unsere Popover API Beispiele Startseite an, um die vollständige Sammlung von MDN Popover-Beispielen zu sehen.
Spezifikationen
Specification |
---|
HTML # the-popover-attribute |
Browser-Kompatibilität
Siehe auch
- Popover API
popovertarget
HTML-Attributpopovertargetaction
HTML-Attribut::backdrop
CSS-Pseudoelement:popover-open
CSS-Pseudoklasse