CKTIS / HTML
onbeforetoggle — obravnava prihajajočo spremembo stanja
Atribut `onbeforetoggle` nastavi obravnavalnik dogodka `beforetoggle`. Dogodek se sproži pred odpiranjem pojavnega okna popover, ne pa pred vsakim zapiranjem. Sproži se tudi pred spremembo stanja elementa `dialog`, ki jo začne metoda, kot je `showModal()` ali `close()`. Če atribut `open` elementu `dialog` dodamo ali odstranimo neposredno, se dogodek ne sproži. Obravnavalnik omogoča preverjanje prejšnjega in predvidenega stanja ter preklic odpiranja.
Različica: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaksa
onbeforetoggle="JavaScript statements"
element.onbeforetoggle = (event) => { /* handler */ };
element.addEventListener("beforetoggle", (event) => { /* listener */ });onbeforetoggle je atribut za obravnavo dogodka beforetoggle; njegova vrednost vsebuje kodo JavaScript, ne logične vrednosti. Ustrezna lastnost je element.onbeforetoggle. Dogodek se sproži pred odpiranjem pojavnega okna popover, ne pa pred vsakim zapiranjem. Če na primer odprto pojavno okno popover odstranimo iz dokumenta, se zapre, ne da bi se sprožil beforetoggle. Zato se na ta dogodek ne zanašajte za zaznavanje vsakega zapiranja. Pri elementu dialog se sproži na primer pri odpiranju z metodo show() ali showModal() ter pri zapiranju z metodo close(). Neposredno dodajanje ali odstranjevanje atributa open spremeni stanje elementa dialog, ne da bi sprožilo beforetoggle.
Objekt ToggleEvent izpostavlja oldState in newState, katerih vrednosti so "closed" ali "open". Pri odpiranju je dogodek mogoče preklicati z event.preventDefault(). Če se sproži pri zapiranju, ga ni mogoče preklicati. toggle je ločen dogodek, ki sporoča spremembo stanja; ne zamenjujte ga z beforetoggle.
Koda v atributu ima dostop do event; return false prav tako prekliče preklicljiv dogodek. Dodelitev funkcije lastnosti element.onbeforetoggle nadomesti obstoječo obravnavo te lastnosti. Druga možnost je addEventListener("beforetoggle", handler), ki omogoča dodajanje neodvisnih poslušalnikov.
Primer prekliče odpiranje, ki ga zahteva showPopover(), zato je pričakovano besedilo open: false. Potreben je brskalnik, ki podpira te funkcije in dovoljuje vstavljene obravnavalnike dogodkov. Zgolj dodajanje onbeforetoggle elementu ne omogoči vedenja pojavnega okna popover.
Primeri
<!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>Rezultat
open: false
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.