CKTIS / HTML
onbeforetoggle — obsluha blížiacej sa zmeny stavu
Atribút `onbeforetoggle` nastavuje obsluhu udalosti `beforetoggle`. Udalosť sa vyvolá pred otvorením popovera, nie však pred každým zatvorením. Vyvolá sa aj pred zmenou stavu prvku `dialog` vykonanou napríklad metódou `showModal()` alebo `close()`. Priame pridanie alebo odstránenie atribútu `open` na prvku `dialog` udalosť nevyvolá. Obsluha umožňuje skontrolovať predchádzajúci a zamýšľaný stav a zrušiť otvorenie.
Verzia: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
onbeforetoggle="JavaScript statements"
element.onbeforetoggle = (event) => { /* handler */ };
element.addEventListener("beforetoggle", (event) => { /* listener */ });onbeforetoggle je atribút obsluhy udalosti beforetoggle; jeho hodnota obsahuje kód JavaScriptu, nie logickú hodnotu. Zodpovedajúcou vlastnosťou je element.onbeforetoggle. Udalosť sa vyvolá pred otvorením popovera, nie však pred každým zatvorením. Ak napríklad odstránite otvorený popover z dokumentu, zatvorí sa bez vyvolania udalosti beforetoggle. Na túto udalosť sa preto nemožno spoliehať pri zisťovaní každého zatvorenia. Pri prvku dialog sa vyvolá napríklad pri otváraní metódou show() alebo showModal() a pri zatváraní metódou close(). Priame pridanie alebo odstránenie atribútu open zmení stav prvku dialog bez vyvolania udalosti beforetoggle.
Objekt ToggleEvent sprístupňuje oldState a newState, ktorých hodnoty sú "closed" alebo "open". Pri otváraní možno udalosť zrušiť pomocou event.preventDefault(). Ak sa udalosť vyvolá pri zatváraní, nedá sa zrušiť. toggle je samostatná udalosť oznamujúca zmenu stavu; nezamieňajte si ju s beforetoggle.
Kód v atribúte má prístup k event; return false tiež zruší zrušiteľnú udalosť. Priradenie funkcie k element.onbeforetoggle nahradí doterajšiu obsluhu tejto vlastnosti. Alternatívne addEventListener("beforetoggle", handler) umožňuje pridávať nezávislých poslucháčov.
Príklad zruší otvorenie vyvolané pomocou showPopover(), takže očakávaný text je open: false. Potrebný je prehliadač, ktorý tieto funkcie podporuje a povoľuje vložené obsluhy udalostí. Samotné pridanie onbeforetoggle prvku nezabezpečí funkciu popovera.
Príklady
<!doctype html>
<meta charset="utf-8">
<title>onbeforetoggle</title>
<div id="panel" popover="manual"
onbeforetoggle="if (event.newState === 'open') event.preventDefault()">
Popover
</div>
<pre id="result"></pre>
<script>
const panel = document.getElementById('panel');
panel.showPopover();
document.getElementById('result').textContent =
'open: ' + panel.matches(':popover-open');
</script>Výsledok
open: false
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.