Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

ToggleEvent

Baseline
Large disponibilité
*

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis novembre 2023.

* Certaines parties de cette fonctionnalité peuvent bénéficier de prise en charge variables.

L'interface ToggleEvent représente un évènement qui se déclenche lorsqu'un élément de type fenêtre contextuelle est basculé entre l'affichage et la dissimulation.

Ceci est l'objet d'évènement pour les évènements beforetoggle et toggle, qui se déclenchent sur les éléments comme suit :

  • L'évènement beforetoggle se déclenche avant que la fenêtre contextuelle ou l'élément <dialog> ne soit affiché ou masqué.
  • L'évènement toggle se déclenche après que la fenêtre contextuelle, l'élément <dialog> ou l'élément <details> ait été affiché ou masqué.
Event ToggleEvent

Constructeur

ToggleEvent()

Crée un objet ToggleEvent.

Propriétés de l'instance

Cette interface hérite des propriétés de son parent, Event.

ToggleEvent.newState Lecture seule

Une chaîne de caractères (soit "open" soit "closed"), représentant l'état vers lequel l'élément est en train de transitionner.

ToggleEvent.oldState Lecture seule

Une chaîne de caractères (soit "open" soit "closed"), représentant l'état depuis lequel l'élément est en train de transitionner.

ToggleEvent.source Lecture seule

Une instance d'objet Element représentant le contrôle HTML qui a initié le basculement.

Exemples

Exemple simple

js
const popover = document.getElementById("mypopover");

// …

popover.addEventListener("beforetoggle", (event) => {
  if (event.newState === "open") {
    console.log("La fenêtre contextuelle est en train d'être affichée");
  } else {
    console.log("La fenêtre contextuelle est en train d'être masquée");
  }
});

Spécifications

Spécification
HTML
# toggleevent

Compatibilité des navigateurs

Voir aussi