blob: eb2aff46746ae8fec241229c1ef37a6c5386660d (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
|
---
title: CustomEvent.initCustomEvent()
slug: Web/API/CustomEvent/initCustomEvent
tags:
- API
- DOM
- Méthodes
translation_of: Web/API/CustomEvent/initCustomEvent
---
{{APIRef("DOM")}}{{deprecated_header}}
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 {{domxref("Document.createEvent()")}}. Cette méthode doit être appelée pour définir l'évènement avant son envoi en utilisant {{domxref("EventTarget.dispatchEvent()") }}. Une fois l'évènement envoyé, la méthode ne fait rien.
> **Attention :** N'utilisez plus cette méthode car elle est dépréciée.
>
> À la place, utilisez les constructeurs d'évènements spécifiques comme {{domxref("CustomEvent.CustomEvent", "CustomEvent()")}}. La page [Création et déclenchement d'évènements](/fr/docs/Web/Guide/DOM/Events/Creating_and_triggering_events) donne plus d'informations sur la façon de les utiliser.
## Syntaxe
event.initCustomEvent(type, canBubble, cancelable, detail);
### Paramètres
- `type`
- : est une {{domxref("DOMString")}} (_chaîne de caractères_) contenant le nom de l'évènement.
- _`canBubble`_
- : est un {{jsxref("Boolean")}} (_booléen_) indiquant si l'événement passe à travers le DOM ou non.
- `cancelable`
- : est un {{jsxref("Boolean")}} indiquant 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 |
| ---------------------------------------------------------------------------------------------------- | -------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| {{SpecName('DOM WHATWG','#dom-customevent-initcustomevent','CustomEvent')}} | {{Spec2('DOM WHATWG')}} | Définition initiale, mais déjà dépréciée au profit de l'utilisation d'un constructeur,{{domxref("CustomEvent.CustomEvent", "CustomEvent()")}} |
## Compatibilité des navigateurs
{{Compat("api.CustomEvent.initCustomEvent")}}
## Voir aussi
- {{domxref("CustomEvent")}}
- Le constructeur à utiliser à la place de cette méthode obsolète : {{domxref("CustomEvent.CustomEvent", "CustomEvent()")}}.
|
