Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / HTML

onbeforetoggle — obrada nadolazeće promjene stanja

Atribut `onbeforetoggle` postavlja rukovatelj za događaj `beforetoggle`. Događaj se pokreće prije otvaranja popovera, ali ne i prije svakog zatvaranja. Pokreće se i prije promjene stanja elementa `dialog` koju započne metoda kao što je `showModal()` ili `close()`. Izravno dodavanje ili uklanjanje atributa `open` na elementu `dialog` ne pokreće događaj. Rukovatelj omogućuje provjeru prethodnog i namjeravanog stanja te otkazivanje otvaranja.

Verzija: 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 rukovanje događajem beforetoggle; njegova vrijednost sadrži JavaScript kod, a ne Booleovu vrijednost. Odgovarajuće svojstvo je element.onbeforetoggle. Događaj se pokreće prije otvaranja popovera, ali ne i prije svakog zatvaranja. Primjerice, uklanjanjem otvorenog popovera iz dokumenta on se zatvara bez pokretanja događaja beforetoggle. Stoga se nemojte oslanjati na ovaj događaj da biste otkrili svako zatvaranje. Na elementu dialog pokreće se, primjerice, pri otvaranju metodom show() ili showModal() te pri zatvaranju metodom close(). Izravno dodavanje ili uklanjanje atributa open mijenja stanje elementa dialog bez pokretanja događaja beforetoggle.

Objekt ToggleEvent izlaže oldState i newState, čije su vrijednosti "closed" ili "open". Pri otvaranju se događaj može otkazati pozivom event.preventDefault(). Ako se pokrene pri zatvaranju, ne može se otkazati. toggle je zaseban događaj koji obavještava o promjeni stanja; nemojte ga miješati s događajem beforetoggle.

Kod u atributu ima pristup varijabli event; return false također otkazuje događaj koji se može otkazati. Dodjela funkcije svojstvu element.onbeforetoggle zamjenjuje postojeći rukovatelj tog svojstva. Druga je mogućnost addEventListener("beforetoggle", handler), koja omogućuje dodavanje neovisnih slušatelja.

Primjer otkazuje otvaranje zatraženo pozivom showPopover(), pa je očekivani tekst open: false. Potreban je preglednik koji podržava ove značajke i dopušta umetnute rukovatelje događajima. Samo dodavanje atributa onbeforetoggle ne daje elementu ponašanje popovera.

Primjeri

<!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

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori