event.initEvent

Obsolète: Cette fonctionnalité a été supprimée des standards du Web. Bien que quelques navigateurs puissent encore la supporter, elle est en cours d'éradication. Ne l'utilisez ni dans d'anciens projets, ni dans de nouveaux. Les pages et applications Web l'utilisant peuvent cesser de fonctionner à tout moment.

La méthode Event.initEvent() est utilisée pour initialiser la valeur d'un objet event créé à l'aide de Document.createEvent().

Les évènements initialisés par ce moyen ont été créés par la méthode Document.createEvent(). Celle-ci doit être appelée à définir l'évènement avant qu'il ne soit distribué, en utilisant EventTarget.dispatchEvent(). Une fois l'évènement transmis, la méthode ne fait plus rien.

Note : Ne pas utiliser cette méthode qui est dépréciée.

À la place, utilisez un constructeur d'évènements spécifique comme Event() . La page Création et déclenchement d'évènements vous donne plus d'informations sur la manière de les utiliser.

Syntaxe

js
event.initEvent(type, bubbles, cancelable);
type

est une DOMString qui définit le type d'évènement.

bubbles

est un Boolean indiquant si l'évènement doit se propager vers le haut dans la chaîne des évènements ou non. Une fois déterminé, la propriété en lecture seule Event.bubbles donnera sa valeur.

cancelable

Une valeur booléenne définissant si l'évènement peut être annulé. Une fois déterminé, la propriété en lecture seule Event.cancelable donnera sa valeur.

Exemple

js
// Crée un évènement.
var event = document.createEvent("Event");

// Crée un évènement click qui doit se propager vers le haut
// et ne peut être annulé
event.initEvent("click", true, false);

// Écoute les évènements.
elem.addEventListener(
  "click",
  function (e) {
    // e.target matches elem
  },
  false,
);

elem.dispatchEvent(event);

Spécifications

Specification
DOM Standard
# ref-for-dom-event-initevent①

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi

  • Le constructeur à utiliser à la place de cette méthode dépréciée : Event(). Des constructeurs plus spécifiques peuvent aussi être utilisés.