Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła