CKTIS / HTML
Das popover-Attribut
Das globale Attribut `popover` erzeugt ein zunächst ausgeblendetes Panel, das über dem Seiteninhalt angezeigt wird. Die Werte `auto`, `manual` und `hint` legen fest, wie es geschlossen wird.
Version: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
popover | popover="" | popover="auto" | popover="manual" | popover="hint"popover ist ein globales Aufzählungsattribut, kein boolesches Attribut. Das Panel ist zunächst ausgeblendet; beim Öffnen wird es in die oberste Ebene (top layer) verschoben. Ohne das Attribut bleibt es ein gewöhnliches Element. Das bloße popover oder popover="" wählt auto; ein ungültiger Wert, einschließlich popover="false", wählt manual, statt die Funktion zu deaktivieren.
auto schließt andere automatische Popovers, mit Ausnahme geeigneter übergeordneter Popovers. Beim Öffnen eines hint-Popovers können andere hint-Popovers geschlossen werden, während die betreffenden übergeordneten Popovers geöffnet bleiben. Ist dem hint-Popover ein geöffnetes auto-Popover übergeordnet, kann das Öffnen auch auto-Popovers schließen, die im Stapel über diesem übergeordneten Popover liegen. Beide Modi unterstützen das Schließen durch Klick außerhalb sowie Schließanforderungen, üblicherweise über Escape. manual schließt weder andere Popovers noch reagiert es auf diese Schließmechanismen.
Das popovertarget eines Buttons verweist auf die id des Panels; die Standardaktion schaltet dessen Sichtbarkeit um. popovertargetaction="hide" schließt es ausdrücklich. JavaScript bietet außerdem showPopover(), hidePopover() und togglePopover(). Platziere das Panel nach Möglichkeit direkt nach seinem Auslöser im DOM, damit die Lesereihenfolge logisch bleibt. Das Attribut ersetzt nicht die für den Inhalt geeignete Barrierefreiheitssemantik.
Beispiele
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Popover example</title>
<button type="button" popovertarget="help">Help</button>
<div id="help" popover="auto">
Settings are saved automatically.
<button type="button" popovertarget="help" popovertargetaction="hide">Close</button>
</div>
</html>Ergebnis
Initially: Help is visible; the popover is hidden. Activate Help: Settings are saved automatically. and Close become visible. Activate Close: the popover is hidden again.
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.