CKTIS / HTML
ontoggle — Änderungen des Öffnungszustands behandeln
Das Attribut ontoggle enthält JavaScript, das das toggle-Ereignis behandelt, nachdem sich der Öffnungszustand eines Elements geändert hat. Dazu gehören unter anderem details, dialog und Elemente, die als Popover fungieren. Das Attribut öffnet oder schließt ein Element nicht selbst.
Version: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
ontoggle="JavaScript statements"
element.ontoggle = (event) => { /* handler */ };
element.addEventListener("toggle", (event) => { /* listener */ });ontoggle ist ein Ereignisbehandlungsattribut für toggle; sein Wert ist JavaScript-Code und kein boolescher Wert. Es ist auf HTML-Elementen verfügbar, doch durch das Hinzufügen entsteht kein Aufklappverhalten. Das Ereignis wird bei Zustandsänderungen von details, dialog und Elementen ausgelöst, die als popover fungieren.
Im Attributcode verweist event auf das Ereignis und this auf das Element, das es behandelt. Das ToggleEvent-Objekt stellt oldState und newState bereit; ihre Werte sind "open" oder "closed". toggle meldet eine abgeschlossene Änderung: Es wird nicht in der Bubbling-Phase weitergegeben und kann nicht abgebrochen werden. preventDefault() macht die Änderung nicht rückgängig.
Die Benachrichtigung wird in die Ereigniswarteschlange gestellt; rasch aufeinanderfolgende Änderungen können zu einem Ereignis zusammengefasst werden. Gehe daher nicht davon aus, dass für jede Zustandsänderung ein Handler-Aufruf erfolgt. beforetoggle ist ein separates Ereignis, das von Mechanismen, die es unterstützen, vor einer Änderung ausgelöst wird. Es ist keine frühere Form von toggle, die für jede details-Änderung verfügbar ist.
In JavaScript kannst du der Eigenschaft element.ontoggle eine Funktion zuweisen; eine weitere Zuweisung ersetzt die vorherige Funktion an dieser Handler-Stelle. Mit addEventListener("toggle", handler) lassen sich unabhängige Listener registrieren. Das Beispiel verwendet das Attribut, um seine Syntax zu zeigen: Das Skript öffnet details, und der Handler aktualisiert den Text, sobald das Ereignis zugestellt wird.
Beispiele
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>ontoggle example</title>
<details id="panel" ontoggle="document.getElementById('status').textContent = event.oldState + ' -> ' + event.newState">
<summary>Details</summary>
<p>Extra information.</p>
</details>
<pre id="status">Waiting</pre>
<script>
document.getElementById('panel').open = true;
</script>
</html>Ergebnis
closed -> open
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.