CKTIS / HTML
ontoggle — obrada promjena stanja otvorenosti
Atribut ontoggle sadrži JavaScript koji obrađuje događaj toggle nakon promjene stanja otvorenosti elementa. Među relevantnim elementima su details, dialog i elementi koji služe kao skočni prozori. Atribut sam ne otvara niti zatvara element.
Verzija: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaksa
ontoggle="JavaScript statements"
element.ontoggle = (event) => { /* handler */ };
element.addEventListener("toggle", (event) => { /* listener */ });ontoggle je atribut za obradu događaja toggle; njegova je vrijednost JavaScript kod, a ne Booleova vrijednost. Dostupan je na HTML elementima, ali njegovo dodavanje ne stvara ponašanje otkrivanja sadržaja. Događaj se generira pri promjenama stanja elemenata details, dialog i elemenata koji služe kao popover.
U kodu atributa event se odnosi na događaj, a this na element koji ga obrađuje. Objekt ToggleEvent pruža oldState i newState, čije su vrijednosti "open" ili "closed". Događaj toggle javlja da je promjena dovršena: ne širi se u fazi bubblinga i ne može se poništiti. preventDefault() neće vratiti promjenu.
Obavijest se stavlja u red čekanja, a brze uzastopne promjene mogu se spojiti u jedan događaj. Zato nemoj pretpostaviti da će se rukovatelj pozvati za svaku promjenu stanja. beforetoggle je zaseban događaj koji mehanizmi koji ga podržavaju šalju prije promjene; nije raniji oblik događaja toggle dostupan za svaku promjenu elementa details.
U JavaScriptu funkciju možeš dodijeliti svojstvu element.ontoggle; nova dodjela zamjenjuje prethodnu funkciju na tom mjestu rukovatelja. addEventListener("toggle", handler) omogućuje registraciju neovisnih slušatelja. Primjer upotrebljava atribut kako bi prikazao njegovu sintaksu: skripta otvara details, a rukovatelj ažurira tekst kad se događaj isporuči.
Primjeri
<!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>Rezultat
closed -> open
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.