Document : méthode createEvent()
Obsolète: Cette fonctionnalité n'est plus recommandée. Même si certains navigateurs la prennent encore en charge, elle a peut-être déjà été supprimée des standards du web, est en passe d'être supprimée ou n'est conservée qu'à des fins de compatibilité. Évitez de l'utiliser et mettez à jour le code existant si possible ; consultez le tableau de compatibilité au bas de cette page pour vous aider à prendre votre décision. Sachez que cette fonctionnalité peut cesser de fonctionner à tout moment.
Attention :
De nombreuses méthodes utilisées avec createEvent, tels que initCustomEvent, sont obsolètes. Utilisez le constructeur d'évènement à la place.
La méthode createEvent() de l'interface Document crée un évènement du type défini. L'objet retourné doit être initialisé avant d'être passé à EventTarget.dispatchEvent.
Syntaxe
createEvent(type)
Paramètres
Valeur de retour
Un objet Event.
Exemples
// Crée l'évènement.
const event = document.createEvent("Event");
// Définit que le nom de l'évènement est 'build'.
event.initEvent("build", true, true);
// Écoute l'évènement.
elem.addEventListener("build", (e) => {
// e.target correspond à elem
});
// L'élément cible peut être n'importe quel 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 (angl.). Gardez à l'esprit que la plupart des objets d'évènement ont maintenant des constructeurs, qui sont la méthode recommandée pour créer des occurrences d'objet d'évènement.
Spécifications
| Specification |
|---|
| DOM # dom-document-createevent |