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 CustomEvent.initCustomEvent() initialise un objet CustomEvent. Si l'évènement a déjà été distribué, cette méthode ne change rien.
Les évènements initialisés par ce moyen doivent être créés avec la méthode Document.createEvent(). Cette méthode doit être appelée pour définir l'évènement avant son envoi en utilisant EventTarget.dispatchEvent(). Une fois l'évènement envoyé, la méthode ne fait rien.
N'utilisez plus cette méthode car elle est dépréciée.
À la place, utilisez les constructeurs d'évènements spécifiques comme CustomEvent(). La page Création et déclenchement d'évènements donne plus d'informations sur la façon de les utiliser.
Syntaxe
event.initCustomEvent(type, canBubble, cancelable, detail);
Paramètres
type- est une
DOMString(chaîne de caractères) contenant le nom de l'évènement. canBubble- est un
Boolean(booléen) indiquant si l'événement passe à travers le DOM ou non. cancelable- est un
Booleanindiquant si l'événement est annulable. detail- Les données transmises lors de l'initialisation de l'évènement.
Spécifications
| Spécification | Statut | Commentaire |
|---|---|---|
| DOM La définition de 'CustomEvent' dans cette spécification. |
Standard évolutif | Définition initiale, mais déjà dépréciée au profit de l'utilisation d'un constructeur,CustomEvent() |
Compatibilité des navigateurs
| Fonctionnalité | Chrome | Edge | Firefox | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|---|
| Support simple | Oui 591 | Oui | 6 | 9 | 11 | 5.1 |
| Fonctionnalité | Android webview | Chrome for Android | Edge mobile | Firefox for Android | Opera Android | iOS Safari | Samsung Internet |
|---|---|---|---|---|---|---|---|
| Support simple | Oui 591 | Oui 591 | Oui | 6 | Oui | Oui | ? |
1. canBubble, cancelable, and detail are optional parameters defaulting to false, false, and null respectively.
Voir aussi
CustomEvent- Le constructeur à utiliser à la place de cette méthode obsolète :
CustomEvent().