aboutsummaryrefslogtreecommitdiff
path: root/files/fr/web/api/customevent
diff options
context:
space:
mode:
authorjulieng <julien.gattelier@gmail.com>2021-10-02 17:20:24 +0200
committerSphinxKnight <SphinxKnight@users.noreply.github.com>2021-10-02 17:30:20 +0200
commit1407c8fdef01ecd0ffb8a8bd46e7113f119b9fde (patch)
tree30a56efd3eff3a01bd1611e1840fdbbfacf544a4 /files/fr/web/api/customevent
parentc05efa8d7ae464235cf83d7c0956e42dc6974103 (diff)
downloadtranslated-content-1407c8fdef01ecd0ffb8a8bd46e7113f119b9fde.tar.gz
translated-content-1407c8fdef01ecd0ffb8a8bd46e7113f119b9fde.tar.bz2
translated-content-1407c8fdef01ecd0ffb8a8bd46e7113f119b9fde.zip
convert content to md
Diffstat (limited to 'files/fr/web/api/customevent')
-rw-r--r--files/fr/web/api/customevent/detail/index.md58
-rw-r--r--files/fr/web/api/customevent/index.md87
-rw-r--r--files/fr/web/api/customevent/initcustomevent/index.md74
3 files changed, 80 insertions, 139 deletions
diff --git a/files/fr/web/api/customevent/detail/index.md b/files/fr/web/api/customevent/detail/index.md
index 17b2453a60..60969648ea 100644
--- a/files/fr/web/api/customevent/detail/index.md
+++ b/files/fr/web/api/customevent/detail/index.md
@@ -8,23 +8,24 @@ tags:
- Évènement personnalisé
translation_of: Web/API/CustomEvent/detail
---
-<p>{{APIRef("DOM")}}</p>
+{{APIRef("DOM")}}
-<p>Le <code><strong>detail</strong></code> de la propriété en lecture seule de l'interface {{domxref("CustomEvent")}} renvoie toutes les données transmises lors de l'initialisation de l'évènement.</p>
+Le **`detail`** de la propriété en lecture seule de l'interface {{domxref("CustomEvent")}} renvoie toutes les données transmises lors de l'initialisation de l'évènement.
-<p>{{AvailableInWorkers}}</p>
+{{AvailableInWorkers}}
-<h2 id="Syntaxe">Syntaxe</h2>
+## Syntaxe
-<pre class="syntaxbox"> let myDetail = <em>customEventInstance.detail</em>;</pre>
+ let myDetail = customEventInstance.detail;
-<h3 id="Valeur_retournée">Valeur retournée</h3>
+### Valeur retournée
-<p>Toute donnée initialisée avec l'évènement.</p>
+Toute donnée initialisée avec l'évènement.
-<h2 id="Exemple">Exemple</h2>
+## Exemple
-<pre class="brush: js">// ajoute un écouteur d'évènement approprié
+```js
+// ajoute un écouteur d'évènement approprié
obj.addEventListener("cat", function(e) { process(e.detail) });
// crée et distribue l'évènement
@@ -36,38 +37,19 @@ let event = new CustomEvent("cat", {
obj.dispatchEvent(event);
// Retournera un objet contenant la propriété hazcheeseburger
-let myDetail = <em>event.detail</em>;
-</pre>
+let myDetail = event.detail;
+```
-<h2 id="Spécifications">Spécifications</h2>
+## Spécifications
-<table class="standard-table">
- <thead>
- <tr>
- <th scope="col">Spécification</th>
- <th scope="col">Statut</th>
- <th scope="col">Commentaire</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td>{{SpecName('DOM WHATWG','#dom-customeventinit-detail','detail')}}</td>
- <td>{{Spec2('DOM WHATWG')}}</td>
- <td>Définition initiale.</td>
- </tr>
- </tbody>
-</table>
+| Spécification | Statut | Commentaire |
+| ---------------------------------------------------------------------------------------- | -------------------------------- | -------------------- |
+| {{SpecName('DOM WHATWG','#dom-customeventinit-detail','detail')}} | {{Spec2('DOM WHATWG')}} | Définition initiale. |
-<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2>
+## Compatibilité des navigateurs
+{{Compat("api.CustomEvent.detail")}}
+## Voir aussi
-<p>{{Compat("api.CustomEvent.detail")}}</p>
-
-<h2 id="Voir_aussi">Voir aussi</h2>
-
-<ul>
- <li>{{domxref("CustomEvent")}}</li>
-</ul>
-
-<p> </p>
+- {{domxref("CustomEvent")}}
diff --git a/files/fr/web/api/customevent/index.md b/files/fr/web/api/customevent/index.md
index 5fcc5dc9a1..e99ca8a535 100644
--- a/files/fr/web/api/customevent/index.md
+++ b/files/fr/web/api/customevent/index.md
@@ -9,83 +9,64 @@ tags:
- évènements
translation_of: Web/API/CustomEvent
---
-<p>{{APIRef("DOM")}}</p>
+{{APIRef("DOM")}}
-<p>Les interfaces <code>CustomEvent</code> DOM sont des évènements initialisés par une application pour n'importe quel usage.</p>
+Les interfaces `CustomEvent` DOM sont des évènements initialisés par une application pour n'importe quel usage.
-<p>{{AvailableInWorkers}}</p>
+{{AvailableInWorkers}}
-<h2 id="Method_overview">Constructeur</h2>
+## Constructeur
-<dl>
- <dt>{{domxref("CustomEvent.CustomEvent", "CustomEvent()")}}</dt>
- <dd>Crée un <code>CustomEvent.</code></dd>
-</dl>
+- {{domxref("CustomEvent.CustomEvent", "CustomEvent()")}}
+ - : Crée un `CustomEvent.`
-<h2 id="Attributes">Propriétés</h2>
+## Propriétés
-<dl>
- <dt>{{domxref("CustomEvent.detail")}} {{readonlyinline}}</dt>
- <dd>Toute donnée transmise lors de l'initialisation de l'événement.</dd>
-</dl>
+- {{domxref("CustomEvent.detail")}} {{readonlyinline}}
+ - : Toute donnée transmise lors de l'initialisation de l'événement.
-<p>Cette interface hérite des propriétés de son parent {{domxref("Event")}}:</p>
+Cette interface hérite des propriétés de son parent {{domxref("Event")}}:
-<p>{{Page("/fr/docs/Web/API/Event", "Propriétés")}}</p>
+{{Page("/fr/docs/Web/API/Event", "Propriétés")}}
-<h2 id="Méthodes">Méthodes</h2>
+## Méthodes
-<dl>
- <dt>{{domxref("CustomEvent.initCustomEvent()")}} {{deprecated_inline}}</dt>
- <dd>Initialise un objet CustomEvent. Si l'événement a déjà été distribué, cette méthode ne fait rien.</dd>
-</dl>
+- {{domxref("CustomEvent.initCustomEvent()")}} {{deprecated_inline}}
+ - : Initialise un objet CustomEvent. Si l'événement a déjà été distribué, cette méthode ne fait rien.
-<p>Cette interface hérite les méthodes de son parent {{domxref("Event")}}:</p>
+Cette interface hérite les méthodes de son parent {{domxref("Event")}}:
-<p>{{Page("/fr/docs/Web/API/Event", "Méthodes")}}</p>
+{{Page("/fr/docs/Web/API/Event", "Méthodes")}}
-<h2 id="Spécifications">Spécifications</h2>
+## Spécifications
-<table class="standard-table">
- <thead>
- <tr>
- <th scope="col">Spécification</th>
- <th scope="col">Statut</th>
- <th scope="col">Commentaire</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td>{{SpecName('DOM WHATWG','#interface-customevent','CustomEvent')}}</td>
- <td>{{Spec2('DOM WHATWG')}}</td>
- <td>Définition initial</td>
- </tr>
- </tbody>
-</table>
+| Spécification | Statut | Commentaire |
+| ---------------------------------------------------------------------------------------- | -------------------------------- | ------------------ |
+| {{SpecName('DOM WHATWG','#interface-customevent','CustomEvent')}} | {{Spec2('DOM WHATWG')}} | Définition initial |
-<h2 id="Browser_compatibility">Compatibilité des navigateurs</h2>
+## Compatibilité des navigateurs
-<p>{{Compat("api.CustomEvent")}}</p>
+{{Compat("api.CustomEvent")}}
-<h2 id="Déclenchement_à_partir_de_code_privilégié_vers_du_code_non-privilégié">Déclenchement à partir de code privilégié vers du code non-privilégié</h2>
+## Déclenchement à partir de code privilégié vers du code non-privilégié
-<p>Lors du déclenchement d'un CustomEvent depuis du code privilégié (une extension, par exemple) vers du code non-privilégié (une page web par exemple), vous devez prendre en considération la sécurité. Firefox et les autres applications Gecko empêchent qu'un objet créé dans un contexte soit utilisé dans un autre, ce qui empêchera généralement les failles de sécurité, mais ces restrictions peuvent aussi empêcher votre code de s'executer comme prévu.</p>
+Lors du déclenchement d'un CustomEvent depuis du code privilégié (une extension, par exemple) vers du code non-privilégié (une page web par exemple), vous devez prendre en considération la sécurité. Firefox et les autres applications Gecko empêchent qu'un objet créé dans un contexte soit utilisé dans un autre, ce qui empêchera généralement les failles de sécurité, mais ces restrictions peuvent aussi empêcher votre code de s'executer comme prévu.
-<p>Lors de la création d'un objet CustomEvent, vous devez créer l'objet à partir de la même <a href="/fr/docs/Mozilla/Tech/XUL/window">fenêtre</a> que celle où vous déclencherez l'évenement.</p>
+Lors de la création d'un objet CustomEvent, vous devez créer l'objet à partir de la même [fenêtre](/fr/docs/Mozilla/Tech/XUL/window) que celle où vous déclencherez l'évenement.
-<pre class="brush: js">// doc est une référence au contenu du document
+```js
+// doc est une référence au contenu du document
function dispatchCustomEvent(doc) {
var eventDetail = Components.utils.cloneInto({foo: 'bar'}, doc.defaultView);
var myEvent = doc.defaultView.CustomEvent("mytype", eventDetail);
doc.dispatchEvent(myEvent);
-}</pre>
+}
+```
-<p>Notez qu'exposer une fonction permettra au script de l'exécuter avec les privilèges qu'accorde Chrome ce qui peut ouvrir une faille de sécurité.</p>
+Notez qu'exposer une fonction permettra au script de l'exécuter avec les privilèges qu'accorde Chrome ce qui peut ouvrir une faille de sécurité.
-<h2 id="Specification">Voir aussi</h2>
+## Voir aussi
-<ul>
- <li><a href="/fr/docs/Extraits_de_code/Interaction_entre_des_pages_%C3%A0_privil%C3%A8ges_et_sans_privil%C3%A8ges">Interaction entre pages privilégiées et non-privilégiées</a></li>
- <li><a href="/fr/docs/Web/API/Window/postMessage">Window.postMessage</a></li>
- <li><a href="/fr/docs/Web/Guide/DOM/Events/Creating_and_triggering_events">Création et déclenchement d'événements</a></li>
-</ul>
+- [Interaction entre pages privilégiées et non-privilégiées](/fr/docs/Extraits_de_code/Interaction_entre_des_pages_%C3%A0_privil%C3%A8ges_et_sans_privil%C3%A8ges)
+- [Window.postMessage](/fr/docs/Web/API/Window/postMessage)
+- [Création et déclenchement d'événements](/fr/docs/Web/Guide/DOM/Events/Creating_and_triggering_events)
diff --git a/files/fr/web/api/customevent/initcustomevent/index.md b/files/fr/web/api/customevent/initcustomevent/index.md
index 29dfb281d8..c95afa7d3d 100644
--- a/files/fr/web/api/customevent/initcustomevent/index.md
+++ b/files/fr/web/api/customevent/initcustomevent/index.md
@@ -7,64 +7,42 @@ tags:
- Méthodes
translation_of: Web/API/CustomEvent/initCustomEvent
---
-<p>{{APIRef("DOM")}}{{deprecated_header}}</p>
+{{APIRef("DOM")}}{{deprecated_header}}
-<p>La méthode <code><strong>CustomEvent.initCustomEvent()</strong></code> initialise un objet <code>CustomEvent</code>. Si l'évènement a déjà été distribué, cette méthode ne change rien.</p>
+La méthode **`CustomEvent.initCustomEvent()`** initialise un objet `CustomEvent`. Si l'évènement a déjà été distribué, cette méthode ne change rien.
-<p>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.</p>
+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.
-<div class="warning">
-<p><strong>Attention :</strong> N'utilisez plus cette méthode car elle est dépréciée.</p>
+> **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.
-<p>À la place, utilisez les constructeurs d'évènements spécifiques comme {{domxref("CustomEvent.CustomEvent", "CustomEvent()")}}. La page <a href="/fr/docs/Web/Guide/DOM/Events/Creating_and_triggering_events">Création et déclenchement d'évènements</a> donne plus d'informations sur la façon de les utiliser.</p>
-</div>
+## Syntaxe
-<h2 id="Syntaxe">Syntaxe</h2>
+ event.initCustomEvent(type, canBubble, cancelable, detail);
-<pre class="syntaxbox"><em>event</em>.initCustomEvent(<em>type</em>, <em>canBubble</em>, <em>cancelable</em>, <em>detail</em>);
-</pre>
+### Paramètres
-<h3 id="Paramètres">Paramètres</h3>
+- `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.
+- _`deta`\*\*`il`_
+ - : Les données transmises lors de l'initialisation de l'évènement.
-<dl>
- <dt><code><em>type</em></code></dt>
- <dd>est une {{domxref("DOMString")}} (<em>chaîne de caractères</em>) contenant le nom de l'évènement.</dd>
- <dt><em><code>canBubble</code></em></dt>
- <dd>est un {{jsxref("Boolean")}} (<em>booléen</em>) indiquant si l'événement passe à travers le DOM ou non.</dd>
- <dt><code><em>cancelable</em></code></dt>
- <dd>est un {{jsxref("Boolean")}} indiquant si l'événement est annulable.</dd>
- <dt><em><code>deta</code></em><em><code>il</code></em></dt>
- <dd>Les données transmises lors de l'initialisation de l'évènement.</dd>
-</dl>
+## Spécifications
-<h2 id="Spécifications">Spécifications</h2>
+| 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()")}} |
-<table class="standard-table">
- <thead>
- <tr>
- <th scope="col">Spécification</th>
- <th scope="col">Statut</th>
- <th scope="col">Commentaire</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td>{{SpecName('DOM WHATWG','#dom-customevent-initcustomevent','CustomEvent')}}</td>
- <td>{{Spec2('DOM WHATWG')}}</td>
- <td>Définition initiale, mais déjà dépréciée au profit de l'utilisation d'un constructeur,{{domxref("CustomEvent.CustomEvent", "CustomEvent()")}}</td>
- </tr>
- </tbody>
-</table>
+## Compatibilité des navigateurs
-<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2>
+{{Compat("api.CustomEvent.initCustomEvent")}}
+## Voir aussi
-
-<p>{{Compat("api.CustomEvent.initCustomEvent")}}</p>
-
-<h2 id="Voir_aussi">Voir aussi</h2>
-
-<ul>
- <li>{{domxref("CustomEvent")}}</li>
- <li>Le constructeur à utiliser à la place de cette méthode obsolète : {{domxref("CustomEvent.CustomEvent", "CustomEvent()")}}.</li>
-</ul>
+- {{domxref("CustomEvent")}}
+- Le constructeur à utiliser à la place de cette méthode obsolète : {{domxref("CustomEvent.CustomEvent", "CustomEvent()")}}.