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

CKTIS / HTML

ontoggle — zpracování změn stavu otevření

Atribut ontoggle obsahuje JavaScript, který zpracuje událost toggle poté, co se změní stav otevření prvku. Patří sem mimo jiné details, dialog a prvky fungující jako popovery. Atribut sám prvek neotevírá ani nezavírá.

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

Syntaxe

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

ontoggle je atribut obsluhy události toggle; jeho hodnotou je kód JavaScriptu, nikoli logická hodnota. Je dostupný na prvcích HTML, ale jeho přidáním nevznikne chování pro rozbalování. Událost se vyvolá při změně stavu prvků details, dialog a prvků fungujících jako popover.

V kódu atributu odkazuje event na událost a this na prvek, který ji obsluhuje. Objekt ToggleEvent poskytuje oldState a newState, jejichž hodnotami jsou "open" nebo "closed". Událost toggle oznamuje dokončenou změnu: neprobublává a nelze ji zrušit. preventDefault() změnu nevrátí zpět.

Oznámení se zařazuje do fronty a rychlé po sobě následující změny se mohou sloučit do jedné události. Nepředpokládejte proto jedno zavolání obsluhy pro každou změnu stavu. beforetoggle je samostatná událost, kterou mechanismy s její podporou vyvolávají před změnou; nejde o dřívější podobu toggle, dostupnou pro každou změnu details.

V JavaScriptu můžete přiřadit funkci vlastnosti element.ontoggle; další přiřazení nahradí předchozí funkci v tomto místě obsluhy. Pomocí addEventListener("toggle", handler) lze registrovat nezávislé posluchače. Příklad používá atribut k předvedení jeho syntaxe: skript otevře details a obsluha po doručení události aktualizuje text.

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

closed -> open

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