CKTIS / HTML
onbeforetoggle — gérer un changement d’état imminent
L’attribut `onbeforetoggle` définit un gestionnaire pour `beforetoggle`. L’événement se déclenche avant l’ouverture d’un popover, mais pas avant toutes les fermetures. Il se déclenche aussi avant les changements d’état d’un élément `dialog` initiés par des méthodes telles que `showModal()` ou `close()`. Ajouter ou retirer directement l’attribut `open` d’un élément `dialog` ne déclenche pas cet événement. Le gestionnaire permet d’examiner l’état précédent et l’état prévu, et d’annuler l’ouverture.
Version : WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
onbeforetoggle="JavaScript statements"
element.onbeforetoggle = (event) => { /* handler */ };
element.addEventListener("beforetoggle", (event) => { /* listener */ });onbeforetoggle est un attribut de gestionnaire d’événement pour beforetoggle ; sa valeur contient du code JavaScript, et non une valeur booléenne. La propriété correspondante est element.onbeforetoggle. L’événement se déclenche avant l’ouverture d’un popover, mais pas avant toutes les fermetures. Par exemple, retirer du document un popover ouvert le ferme sans déclencher beforetoggle. Ne comptez donc pas sur cet événement pour détecter toutes les fermetures. Pour un élément dialog, il se déclenche notamment à l’ouverture avec show() ou showModal() et à la fermeture avec close(). Ajouter ou retirer directement l’attribut open modifie l’état de l’élément dialog sans déclencher beforetoggle.
L’objet ToggleEvent expose oldState et newState, dont les valeurs sont "closed" ou "open". Lors de l’ouverture, l’événement peut être annulé avec event.preventDefault(). S’il se déclenche lors de la fermeture, il ne peut pas être annulé. toggle est un événement distinct qui signale un changement d’état ; ne le confondez pas avec beforetoggle.
Le code de l’attribut a accès à event ; return false annule également un événement annulable. Affecter une fonction à element.onbeforetoggle remplace le gestionnaire existant de cette propriété. Autre possibilité : addEventListener("beforetoggle", handler) permet d’ajouter des écouteurs indépendants.
L’exemple annule l’ouverture demandée par showPopover() ; le texte attendu est donc open: false. Il faut un navigateur qui prend en charge ces fonctionnalités et autorise les gestionnaires d’événement en ligne. Ajouter onbeforetoggle ne confère pas, à lui seul, un comportement de popover à un élément.
Exemples
<!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>Résultat
open: false
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.