CKTIS / HTML
onbeforetoggle — eine bevorstehende Zustandsänderung behandeln
Das Attribut `onbeforetoggle` legt einen Handler für `beforetoggle` fest. Das Ereignis wird vor dem Öffnen eines Popovers ausgelöst, aber nicht vor jedem Schließen. Es wird auch vor Zustandsänderungen eines Dialogs ausgelöst, die durch Methoden wie `showModal()` oder `close()` angestoßen werden. Das direkte Hinzufügen oder Entfernen des Attributs `open` am Dialog löst das Ereignis nicht aus. Der Handler kann den vorherigen und den vorgesehenen Zustand prüfen und das Öffnen abbrechen.
Version: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
onbeforetoggle="JavaScript statements"
element.onbeforetoggle = (event) => { /* handler */ };
element.addEventListener("beforetoggle", (event) => { /* listener */ });onbeforetoggle ist ein Event-Handler-Attribut für beforetoggle; sein Wert enthält JavaScript-Code und keinen booleschen Wert. Die zugehörige Eigenschaft ist element.onbeforetoggle. Das Ereignis wird vor dem Öffnen eines Popovers ausgelöst, aber nicht vor jedem Schließen. Wird beispielsweise ein geöffnetes Popover aus dem Dokument entfernt, schließt es sich, ohne dass beforetoggle ausgelöst wird. Verlass dich daher nicht auf dieses Ereignis, um jedes Schließen zu erfassen. Bei einem dialog-Element wird es beispielsweise beim Öffnen mit show() oder showModal() und beim Schließen mit close() ausgelöst. Das direkte Hinzufügen oder Entfernen des Attributs open ändert den Zustand des Dialogs, ohne beforetoggle auszulösen.
Das ToggleEvent-Objekt stellt oldState und newState bereit. Ihre Werte sind "closed" oder "open". Beim Öffnen kann das Ereignis mit event.preventDefault() abgebrochen werden. Wird es beim Schließen ausgelöst, ist es nicht abbrechbar. toggle ist ein separates Ereignis, das eine Zustandsänderung meldet; verwechsle es nicht mit beforetoggle.
Im Attributcode ist event verfügbar; return false bricht ebenfalls ein abbrechbares Ereignis ab. Eine Funktion, die element.onbeforetoggle zugewiesen wird, ersetzt den bisherigen Handler dieser Eigenschaft. Alternativ ermöglicht addEventListener("beforetoggle", handler) das Hinzufügen unabhängiger Listener.
Das Beispiel bricht das durch showPopover() angeforderte Öffnen ab; daher lautet der erwartete Text open: false. Erforderlich ist ein Browser, der diese Funktionen unterstützt und Inline-Event-Handler zulässt. Allein durch das Hinzufügen von onbeforetoggle erhält ein Element keine Popover-Funktionalität.
Beispiele
<!doctype html>
<meta charset="utf-8">
<title>onbeforetoggle</title>
<div id="panel" popover="manual"
onbeforetoggle="if (event.newState === 'open') event.preventDefault()">
Popover
</div>
<pre id="result"></pre>
<script>
const panel = document.getElementById('panel');
panel.showPopover();
document.getElementById('result').textContent =
'open: ' + panel.matches(':popover-open');
</script>Ergebnis
open: false
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.