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
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 seuleEvent.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
// 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.