CKTIS / HTML
ontoggle — obravnavanje sprememb stanja odprtosti
Atribut ontoggle vsebuje JavaScript, ki obravnava dogodek toggle, potem ko se spremeni stanje odprtosti elementa. Med ustrezne elemente spadajo details, dialog in elementi, ki delujejo kot pojavna okna. Atribut sam elementa ne odpre ali zapre.
Različica: 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 obravnavo dogodka toggle; njegova vrednost je koda JavaScript, ne logična vrednost. Na voljo je na elementih HTML, vendar samo z dodajanjem tega atributa element ne dobi možnosti razkrivanja vsebine. Dogodek se sproži ob spremembah stanja elementov details, dialog in elementov, ki delujejo kot popover.
V kodi atributa se event nanaša na dogodek, this pa na element, ki ga obravnava. Objekt ToggleEvent ponuja oldState in newState, katerih vrednosti sta "open" ali "closed". Dogodek toggle sporoča že izvedeno spremembo: se ne širi z mehurčkanjem in ga ni mogoče preklicati. preventDefault() spremembe ne razveljavi.
Obvestilo se uvrsti v čakalno vrsto, hitre zaporedne spremembe pa se lahko združijo v en dogodek. Zato ne predpostavljaj, da bo obravnavalnik poklican za vsako spremembo stanja. beforetoggle je ločen dogodek, ki ga mehanizmi s podporo zanj sprožijo pred spremembo; ni zgodnejša oblika dogodka toggle, ki bi bila na voljo pri vsaki spremembi elementa details.
V JavaScriptu lahko funkcijo dodeliš lastnosti element.ontoggle; nova dodelitev zamenja prejšnjo funkcijo na tem mestu obravnave. Z addEventListener("toggle", handler) registriraš neodvisne poslušalce. Primer uporablja atribut za prikaz njegove sintakse: skript odpre details, obravnavalnik pa ob dostavi dogodka posodobi besedilo.
Primeri
<!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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.