CKTIS / HTML
ontoggle — spracovanie zmien stavu otvorenia
Atribút ontoggle obsahuje JavaScript, ktorý spracuje udalosť toggle po zmene stavu otvorenia prvku. Patria sem okrem iného details, dialog a prvky fungujúce ako popovery. Atribút sám prvok neotvára ani nezatvára.
Verzia: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
ontoggle="JavaScript statements"
element.ontoggle = (event) => { /* handler */ };
element.addEventListener("toggle", (event) => { /* listener */ });ontoggle je atribút obsluhy udalosti toggle; jeho hodnotou je kód JavaScriptu, nie logická hodnota. Je dostupný na prvkoch HTML, ale jeho pridaním nevznikne správanie na rozbaľovanie. Udalosť sa vyvolá pri zmene stavu prvkov details, dialog a prvkov fungujúcich ako popover.
V kóde atribútu odkazuje event na udalosť a this na prvok, ktorý ju obsluhuje. Objekt ToggleEvent poskytuje oldState a newState, ktorých hodnotami sú "open" alebo "closed". Udalosť toggle oznamuje dokončenú zmenu: nebublá a nedá sa zrušiť. preventDefault() zmenu nevráti späť.
Oznámenie sa zaradí do frontu a rýchle po sebe nasledujúce zmeny sa môžu zlúčiť do jednej udalosti. Nepredpokladajte preto jedno zavolanie obsluhy pri každej zmene stavu. beforetoggle je samostatná udalosť, ktorú mechanizmy s jej podporou vyvolávajú pred zmenou; nejde o skoršiu podobu toggle, dostupnú pri každej zmene details.
V JavaScripte môžete priradiť funkciu vlastnosti element.ontoggle; ďalšie priradenie nahradí predchádzajúcu funkciu v tomto mieste obsluhy. Pomocou addEventListener("toggle", handler) možno registrovať nezávislých poslucháčov. Príklad používa atribút na ukážku jeho syntaxe: skript otvorí details a obsluha po doručení udalosti aktualizuje text.
Príklady
<!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>Výsledok
closed -> open
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.