Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

onbeforetoggle — obsługa zdarzenia przed zmianą stanu

Atrybut `onbeforetoggle` ustawia kod obsługi zdarzenia `beforetoggle`. Zdarzenie jest wywoływane przed otwarciem popovera, ale nie przed każdym jego zamknięciem. W przypadku elementu `dialog` jest wywoływane na przykład przy użyciu metod `showModal()` lub `close()`. Bezpośrednie dodanie lub usunięcie atrybutu `open` elementu `dialog` nie wywołuje zdarzenia. Kod obsługi pozwala sprawdzić poprzedni i docelowy stan oraz anulować otwarcie.

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

Składnia

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

onbeforetoggle to atrybut obsługi zdarzenia beforetoggle; jego wartość zawiera kod JavaScript, a nie wartość logiczną. Odpowiada mu właściwość element.onbeforetoggle. Zdarzenie występuje przed otwarciem popovera, ale nie przed każdym jego zamknięciem. Na przykład usunięcie otwartego popovera z dokumentu zamyka go bez wywołania beforetoggle. Nie można więc polegać na tym zdarzeniu, aby wykryć każde zamknięcie. W przypadku elementu dialog zdarzenie jest wywoływane między innymi przy otwieraniu metodą show() lub showModal() oraz przy zamykaniu metodą close(). Bezpośrednie dodanie lub usunięcie atrybutu open zmienia stan elementu dialog bez wywołania beforetoggle.

Obiekt ToggleEvent udostępnia oldState i newState o wartościach "closed" lub "open". Przy otwieraniu zdarzenie można anulować przez event.preventDefault(). Jeśli zdarzenie wystąpi przy zamykaniu, nie można go anulować. toggle jest odrębnym zdarzeniem powiadamiającym o zmianie stanu; nie należy mylić go z beforetoggle.

W atrybucie kod ma dostęp do event; return false również anuluje anulowalne zdarzenie. Przypisanie funkcji do element.onbeforetoggle zastępuje dotychczasową funkcję tej właściwości. Alternatywa addEventListener("beforetoggle", handler) pozwala dodawać niezależne funkcje obsługi.

Przykład anuluje otwarcie wywołane przez showPopover(), więc oczekiwany tekst to open: false. Wymaga przeglądarki obsługującej te mechanizmy i dozwolonych skryptów obsługi w atrybutach. Samo dodanie onbeforetoggle nie nadaje elementowi funkcji popovera.

Przykłady

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

Wynik

open: false

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła