KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / HTML

onbeforetoggle — een aankomende statuswijziging afhandelen

Het attribuut `onbeforetoggle` stelt een handler in voor `beforetoggle`. De gebeurtenis treedt op voordat een popover wordt geopend, maar niet elke keer dat de popover wordt gesloten. De gebeurtenis treedt ook op voordat een `dialog`-element van status verandert door een methode zoals `showModal()` of `close()`. Het rechtstreeks toevoegen of verwijderen van het attribuut `open` van een `dialog`-element activeert de gebeurtenis niet. De handler kan de vorige en beoogde status controleren en het openen annuleren.

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

Syntax

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

onbeforetoggle is een eventhandlerattribuut voor beforetoggle; de waarde bevat JavaScript-code, geen booleaanse waarde. De bijbehorende property is element.onbeforetoggle. De gebeurtenis treedt op voordat een popover wordt geopend, maar niet elke keer dat de popover wordt gesloten. Als je bijvoorbeeld een geopende popover uit het document verwijdert, wordt die gesloten zonder dat beforetoggle optreedt. Vertrouw dus niet op deze gebeurtenis om elke sluiting te detecteren. Bij een dialog-element treedt de gebeurtenis bijvoorbeeld op bij het openen met show() of showModal() en bij het sluiten met close(). Door het attribuut open rechtstreeks toe te voegen of te verwijderen, verandert de status van het dialog-element zonder dat beforetoggle optreedt.

Het ToggleEvent-object biedt oldState en newState, met als mogelijke waarden "closed" of "open". Bij het openen kan de gebeurtenis worden geannuleerd met event.preventDefault(). Als de gebeurtenis bij het sluiten optreedt, kan die niet worden geannuleerd. toggle is een aparte gebeurtenis die een statuswijziging meldt; verwar die niet met beforetoggle.

In attribuutcode is event beschikbaar; return false annuleert eveneens een annuleerbare gebeurtenis. Een functie toewijzen aan element.onbeforetoggle vervangt de bestaande handler van die property. Met addEventListener("beforetoggle", handler) kunnen in plaats daarvan onafhankelijke listeners worden toegevoegd.

Het voorbeeld annuleert het openen dat door showPopover() wordt aangevraagd. De verwachte tekst is daarom open: false. Hiervoor is een browser nodig die deze functies implementeert en inline eventhandlers toestaat. Alleen onbeforetoggle toevoegen geeft een element geen popoverfunctionaliteit.

Voorbeelden

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

Resultaat

open: false

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen