Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / HTML

onbeforetoggle — obsluha blížící se změny stavu

Atribut `onbeforetoggle` nastavuje obsluhu události `beforetoggle`. Událost se vyvolá před otevřením popoveru, ale ne před každým zavřením. Vyvolá se také před změnou stavu prvku `dialog` provedenou například metodou `showModal()` nebo `close()`. Přímé přidání nebo odebrání atributu `open` u prvku `dialog` událost nevyvolá. Obsluha umožňuje zkontrolovat předchozí a zamýšlený stav a zrušit otevření.

Verze: WHATWG HTML Living Standard; index snapshot date recorded separately

Syntaxe

onbeforetoggle="JavaScript statements"
element.onbeforetoggle = (event) => { /* handler */ };
element.addEventListener("beforetoggle", (event) => { /* listener */ });

onbeforetoggle je atribut obsluhy události beforetoggle; jeho hodnota obsahuje kód JavaScriptu, nikoli logickou hodnotu. Odpovídající vlastností je element.onbeforetoggle. Událost se vyvolá před otevřením popoveru, ale ne před každým zavřením. Pokud například odeberete otevřený popover z dokumentu, zavře se bez vyvolání události beforetoggle. Na tuto událost se tedy nelze spoléhat při zjišťování každého zavření. U prvku dialog se vyvolá například při otevírání metodou show() nebo showModal() a při zavírání metodou close(). Přímé přidání nebo odebrání atributu open změní stav prvku dialog, aniž by se vyvolala událost beforetoggle.

Objekt ToggleEvent zpřístupňuje oldState a newState, jejichž hodnoty jsou "closed" nebo "open". Při otevírání lze událost zrušit pomocí event.preventDefault(). Pokud se událost vyvolá při zavírání, zrušit ji nelze. toggle je samostatná událost oznamující změnu stavu; nezaměňujte ji s beforetoggle.

Kód v atributu má přístup k event; return false také ruší zrušitelnou událost. Přiřazení funkce k element.onbeforetoggle nahradí dosavadní obsluhu této vlastnosti. Alternativně addEventListener("beforetoggle", handler) umožňuje přidávat nezávislé posluchače.

Příklad zruší otevření vyvolané pomocí showPopover(), takže očekávaný text je open: false. Je potřeba prohlížeč, který tyto funkce podporuje a povoluje vložené obsluhy událostí. Samotné přidání onbeforetoggle prvku nezajistí funkci popoveru.

Pří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ýsledek

open: false

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje