CKTIS / HTML
ontoggle — obsługa zmiany stanu otwarcia
Atrybut ontoggle zawiera kod JavaScript obsługujący zdarzenie toggle po zmianie stanu otwarcia elementu. Dotyczy między innymi details, dialog i elementów działających jako popover. Sam nie otwiera ani nie zamyka elementu.
Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately
Składnia
ontoggle="JavaScript statements"
element.ontoggle = (event) => { /* handler */ };
element.addEventListener("toggle", (event) => { /* listener */ });ontoggle to atrybut obsługi zdarzenia toggle; jego wartością jest kod JavaScript, a nie wartość logiczna. Jest dostępny na elementach HTML, lecz samo jego dodanie nie nadaje funkcji rozwijania. Zdarzenie jest generowane przy zmianach stanu details, dialog oraz elementów działających jako popover.
W kodzie atrybutu event oznacza zdarzenie, a this — element obsługujący je. Obiekt ToggleEvent udostępnia oldState i newState, których wartościami są "open" lub "closed". toggle informuje o dokonanej zmianie: nie propaguje się w fazie bąbelkowania i nie można go anulować. preventDefault() nie cofnie zmiany.
Powiadomienie jest kolejkowane, a szybkie kolejne zmiany mogą zostać scalone w jedno zdarzenie. Nie zakładaj więc jednego wywołania dla każdej zmiany stanu. beforetoggle jest odrębnym zdarzeniem występującym przed zmianą w obsługujących je mechanizmach; nie jest wcześniejszą odmianą toggle dostępną dla każdej zmiany details.
W JavaScript można przypisać funkcję do właściwości element.ontoggle; kolejne przypisanie zastępuje poprzednią funkcję w tym miejscu obsługi. addEventListener("toggle", handler) pozwala rejestrować niezależne nasłuchy. Przykład używa atrybutu, aby pokazać jego składnię: skrypt otwiera details, a obsługa aktualizuje tekst po dostarczeniu zdarzenia.
Przykłady
<!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>Wynik
closed -> open
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.