CKTIS / HTML
ontoggle — gestire i cambiamenti dello stato di apertura
L’attributo ontoggle contiene JavaScript che gestisce l’evento toggle dopo che cambia lo stato di apertura di un elemento. Tra gli elementi pertinenti ci sono details, dialog e quelli che fungono da popover. L’attributo non apre né chiude un elemento da solo.
Versione: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintassi
ontoggle="JavaScript statements"
element.ontoggle = (event) => { /* handler */ };
element.addEventListener("toggle", (event) => { /* listener */ });ontoggle è un attributo di gestione dell’evento toggle; il suo valore è codice JavaScript, non un valore booleano. È disponibile sugli elementi HTML, ma aggiungerlo non crea un comportamento di espansione. L’evento viene generato quando cambia lo stato di details, dialog e degli elementi che fungono da popover.
Nel codice dell’attributo, event fa riferimento all’evento e this all’elemento che lo gestisce. L’oggetto ToggleEvent fornisce oldState e newState, i cui valori sono "open" o "closed". toggle segnala un cambiamento già avvenuto: non si propaga nella fase di bubbling e non può essere annullato. preventDefault() non ripristina lo stato precedente.
La notifica viene messa in coda e cambiamenti rapidi e successivi possono essere accorpati in un unico evento. Non dare quindi per scontato che il gestore venga chiamato per ogni cambiamento di stato. beforetoggle è un evento distinto, inviato prima di un cambiamento dai meccanismi che lo supportano; non è una forma precedente di toggle disponibile per ogni cambiamento di details.
In JavaScript puoi assegnare una funzione alla proprietà element.ontoggle; una nuova assegnazione sostituisce la funzione precedente in quello spazio del gestore. addEventListener("toggle", handler) consente di registrare listener indipendenti. L’esempio usa l’attributo per mostrarne la sintassi: lo script apre details e il gestore aggiorna il testo quando viene recapitato l’evento.
Esempi
<!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>Risultato
closed -> open
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.