diff options
author | julieng <julien.gattelier@gmail.com> | 2021-10-02 17:20:24 +0200 |
---|---|---|
committer | SphinxKnight <SphinxKnight@users.noreply.github.com> | 2021-10-02 17:30:20 +0200 |
commit | 1407c8fdef01ecd0ffb8a8bd46e7113f119b9fde (patch) | |
tree | 30a56efd3eff3a01bd1611e1840fdbbfacf544a4 /files/fr/web/api/event/initevent | |
parent | c05efa8d7ae464235cf83d7c0956e42dc6974103 (diff) | |
download | translated-content-1407c8fdef01ecd0ffb8a8bd46e7113f119b9fde.tar.gz translated-content-1407c8fdef01ecd0ffb8a8bd46e7113f119b9fde.tar.bz2 translated-content-1407c8fdef01ecd0ffb8a8bd46e7113f119b9fde.zip |
convert content to md
Diffstat (limited to 'files/fr/web/api/event/initevent')
-rw-r--r-- | files/fr/web/api/event/initevent/index.md | 125 |
1 files changed, 51 insertions, 74 deletions
diff --git a/files/fr/web/api/event/initevent/index.md b/files/fr/web/api/event/initevent/index.md index 6f06e8b7f3..fceca59b46 100644 --- a/files/fr/web/api/event/initevent/index.md +++ b/files/fr/web/api/event/initevent/index.md @@ -9,77 +9,54 @@ tags: - Reference translation_of: Web/API/Event/initEvent --- -<p>{{ApiRef("DOM")}}{{deprecated_header}}</p> - -<p>La méthode <strong><code>Event.initEvent()</code></strong> est utilisée pour initialiser la valeur d'un objet {{domxref("event")}} créé à l'aide de {{domxref("Document.createEvent()")}}.</p> - -<p>Les évènements initialisés par ce moyen ont été créés par la méthode {{domxref("Document.createEvent()")}}. Celle-ci doit être appelée à définir l'évènement avant qu'il ne soit distribué, en utilisant {{domxref("EventTarget.dispatchEvent()")}}. Une fois l'évènement transmis, la méthode ne fait plus rien.</p> - -<div class="note"> -<p><strong>Note :</strong> Ne pas utiliser cette méthode qui est dépréciée.</p> - -<p>À la place, utilisez un constructeur d'évènements spécifique comme {{domxref("Event.Event", "Event()")}} . La page <a href="/fr/docs/Web/Guide/DOM/Events/Creating_and_triggering_events">Création et déclenchement d'évènements</a> vous donne plus d'informations sur la manière de les utiliser.</p> -</div> - -<h2 id="Syntaxe">Syntaxe</h2> - -<pre class="eval"><em>event</em>.initEvent(<em>type</em>, <em>bubbles</em>, <em>cancelable</em>) -</pre> - -<dl> - <dt><code>type</code></dt> - <dd>est une {{domxref("DOMString")}} qui définit le type d'évènement.</dd> - <dt><code>bubbles</code></dt> - <dd>est un {{jsxref("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 seule {{domxref("Event.bubbles")}} donnera sa valeur.</dd> - <dt><code>cancelable</code></dt> - <dd>Une valeur booléenne définissant si l'évènement peut être annulé. Une fois déterminé, la propriété en lecture seule {{ domxref("Event.cancelable") }} donnera sa valeur.</dd> -</dl> - -<h2 id="Exemple">Exemple</h2> - -<pre><code>// Crée un évènement. -var event = document.createEvent('Event'); -</code> -// Crée un évènement click qui doit se propager vers le haut -// et ne peut être annulé<code> -event.initEvent('click', true, false); - -// Écoute les évènements. -elem.addEventListener('click', function (e) { - // e.target matches elem -}, false); - -elem.dispatchEvent(event);</code> -</pre> - -<h2 id="Spécifications">Spécifications</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Spécification</th> - <th scope="col">Statut</th> - <th scope="col">Commentaire</th> - </tr> - <tr> - <td>{{SpecName('DOM WHATWG', '#dom-event-initevent','Event.initEvent()')}}</td> - <td>{{Spec2("DOM WHATWG")}}</td> - <td>Depuis {{SpecName('DOM2 Events')}}, dépréciée, remplacée par les constructeurs d'événements.</td> - </tr> - <tr> - <td>{{SpecName('DOM2 Events','##Events-Event-initEvent','Event.initEvent()')}}</td> - <td>{{Spec2('DOM2 Events')}}</td> - <td>Définition initiale.</td> - </tr> - </tbody> -</table> - -<h2 id="Browser_compatibility">Compatibilité des navigateurs</h2> - -<p>{{Compat("api.Event.initEvent")}}</p> - -<h2 id="See_also">Voir aussi</h2> - -<ul> - <li>Le constructeur à utiliser à la place de cette méthode dépréciée : {{domxref("Event.Event","Event()")}}. Des constructeurs plus spécifiques peuvent aussi être utilisés.</li> -</ul> +{{ApiRef("DOM")}}{{deprecated_header}} + +La méthode **`Event.initEvent()`** est utilisée pour initialiser la valeur d'un objet {{domxref("event")}} créé à l'aide de {{domxref("Document.createEvent()")}}. + +Les évènements initialisés par ce moyen ont été créés par la méthode {{domxref("Document.createEvent()")}}. Celle-ci doit être appelée à définir l'évènement avant qu'il ne soit distribué, en utilisant {{domxref("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 {{domxref("Event.Event", "Event()")}} . La page [Création et déclenchement d'évènements](/fr/docs/Web/Guide/DOM/Events/Creating_and_triggering_events) vous donne plus d'informations sur la manière de les utiliser. + +## Syntaxe + + event.initEvent(type, bubbles, cancelable) + +- `type` + - : est une {{domxref("DOMString")}} qui définit le type d'évènement. +- `bubbles` + - : est un {{jsxref("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 seule {{domxref("Event.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 {{ domxref("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 + +| Spécification | Statut | Commentaire | +| ---------------------------------------------------------------------------------------------------- | -------------------------------- | ----------------------------------------------------------------------------------------------------- | +| {{SpecName('DOM WHATWG', '#dom-event-initevent','Event.initEvent()')}} | {{Spec2("DOM WHATWG")}} | Depuis {{SpecName('DOM2 Events')}}, dépréciée, remplacée par les constructeurs d'événements. | +| {{SpecName('DOM2 Events','##Events-Event-initEvent','Event.initEvent()')}} | {{Spec2('DOM2 Events')}} | Définition initiale. | + +## Compatibilité des navigateurs + +{{Compat("api.Event.initEvent")}} + +## Voir aussi + +- Le constructeur à utiliser à la place de cette méthode dépréciée : {{domxref("Event.Event","Event()")}}. Des constructeurs plus spécifiques peuvent aussi être utilisés. |