Document.createEvent()

Attention : De nombreuses méthodes utilisées avec createEvent, tels que initCustomEvent, sont obsolètes. Utilisez le constructeur d'évènement à la place.

Crée un event du type spécifié. L'objet retourné doit être intialisé et peut être passé ensuite à element.dispatchEvent.

Syntaxe

js
var event = document.createEvent(type);
  • event est l'objet Event créé.
  • type est une chaîne de caractères qui représente le type d'événement à créer. Les types possibles d'événement incluent "UIEvents", "MouseEvents", "MutationEvents" et "HTMLEvents". Voir la section Notes pour plus de détails.

Exemple

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

// Nomme l'événement 'build'.
event.initEvent("build", true, true);

//  Écoute l'événement.
elem.addEventListener(
  "build",
  function (e) {
    // e.target correspond à elem
  },
  false,
);

// target peut être tout Element ou autre EventTarget.
elem.dispatchEvent(event);

Notes

Les chaînes de type d'événement appropriées pour passer à createEvent () sont répertoriées dans la norme DOM - voir le tableau à l'étape 2. Gardez à l'esprit que la plupart des objets événement ont maintenant des constructeurs, qui sont la méthode recommandée pour créer des occurrences d'objet événement.

Gecko prend en charge certains alias d'objet événement non standard, répertoriés ci-dessous :

Event Module Standard event object Gecko also supports
Text event module TextEvent TextEvents
Keyboard event module KeyboardEvent KeyEvents
Basic events module Event Events

Spécification

Voir aussi