CKTIS / HTML
ontoggle — wijzigingen in de open status afhandelen
Het attribuut ontoggle bevat JavaScript dat de toggle-gebeurtenis afhandelt nadat de open status van een element is gewijzigd. Dit geldt onder meer voor details, dialog en elementen die als popover fungeren. Het attribuut opent of sluit een element niet zelf.
Versie: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
ontoggle="JavaScript statements"
element.ontoggle = (event) => { /* handler */ };
element.addEventListener("toggle", (event) => { /* listener */ });ontoggle is een attribuut voor het afhandelen van de gebeurtenis toggle; de waarde is JavaScript-code, geen Booleaanse waarde. Het is beschikbaar op HTML-elementen, maar door het toe te voegen ontstaat geen uitklapgedrag. De gebeurtenis wordt gegenereerd bij statuswijzigingen van details, dialog en elementen die als popover fungeren.
In de attribuutcode verwijst event naar de gebeurtenis en this naar het element dat deze afhandelt. Het ToggleEvent-object biedt oldState en newState, met als waarden "open" of "closed". toggle meldt een voltooide wijziging: de gebeurtenis bubbelt niet en kan niet worden geannuleerd. preventDefault() maakt de wijziging niet ongedaan.
De melding wordt in de wachtrij geplaatst en snelle opeenvolgende wijzigingen kunnen worden samengevoegd tot één gebeurtenis. Ga er dus niet van uit dat de handler voor elke statuswijziging wordt aangeroepen. beforetoggle is een afzonderlijke gebeurtenis die mechanismen die deze ondersteunen vóór een wijziging versturen; het is geen eerdere vorm van toggle die beschikbaar is voor elke wijziging van details.
In JavaScript kun je een functie toewijzen aan de eigenschap element.ontoggle; een volgende toewijzing vervangt de vorige functie op die handlerplek. Met addEventListener("toggle", handler) registreer je onafhankelijke luisteraars. Het voorbeeld gebruikt het attribuut om de syntaxis te laten zien: het script opent details, waarna de handler de tekst bijwerkt zodra de gebeurtenis wordt afgeleverd.
Voorbeelden
<!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>Resultaat
closed -> open
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.