Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje