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
Boolean
indiquant si l'événement est annulable. deta
il
- 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
Ordinateur | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
initCustomEvent | Chrome
Support complet
Oui
| Edge Support complet 14 | Firefox Support complet 6 | IE Support complet 9 | Opera Support complet 11 | Safari Support complet 5.1 | WebView Android
Support complet
Oui
| Chrome Android
Support complet
Oui
| Firefox Android Support complet 6 | Opera Android Support complet Oui | Safari iOS Support complet Oui | Samsung Internet Android ? |
Légende
- Support complet
- Support complet
- Compatibilité inconnue
- Compatibilité inconnue
- Obsolète. Les nouveaux sites web ne doivent pas utiliser cette fonctionnalité.
- Obsolète. Les nouveaux sites web ne doivent pas utiliser cette fonctionnalité.
- Voir les notes d'implémentation.
- Voir les notes d'implémentation.
Voir aussi
CustomEvent
- Le constructeur à utiliser à la place de cette méthode obsolète :
CustomEvent()
.