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

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.

Zdroje