diff options
Diffstat (limited to 'files/fr/web/api/mutationobserver/index.html')
| -rw-r--r-- | files/fr/web/api/mutationobserver/index.html | 44 |
1 files changed, 24 insertions, 20 deletions
diff --git a/files/fr/web/api/mutationobserver/index.html b/files/fr/web/api/mutationobserver/index.html index a5b0592dcd..2be16d34b7 100644 --- a/files/fr/web/api/mutationobserver/index.html +++ b/files/fr/web/api/mutationobserver/index.html @@ -7,22 +7,22 @@ translation_of: Web/API/MutationObserver <p><code>MutationObserver</code> fournit un moyen d’intercepter les changements dans le <a href="/en-US/docs/DOM">DOM</a>. Il a été conçu pour remplacer les <a href="/en-US/docs/DOM/Mutation_events">Mutation Events</a> définis dans la spécification DOM3 Events.</p> -<h2 id="Constructor" name="Constructor">Constructeur</h2> +<h2 id="Constructor">Constructeur</h2> -<h3 id="MutationObserver()" name="MutationObserver()"><code>MutationObserver()</code></h3> +<h3 id="MutationObserver()"><code>MutationObserver()</code></h3> <p>Le constructeur permettant d’instancier un nouvel observateur de mutations DOM.</p> <pre class="syntaxbox">new MutationObserver( function callback );</pre> -<h6 id="Parameters" name="Parameters">Paramètres</h6> +<h4 id="Parameters">Paramètres</h4> <dl> <dt><code>callback</code></dt> <dd>Une fonction qui sera appelée à chaque mutation du DOM. L’observateur appellera cette fonction avec deux arguments. Le premier est un tableau d’objets de type {{domxref("MutationRecord")}} ; le second est l’instance de <code>MutationObserver</code>.</dd> </dl> -<h2 id="Instance_methods" name="Instance_methods">Méthodes d’instance</h2> +<h2 id="Instance_methods">Méthodes d’instance</h2> <table class="standard-table"> <tbody> @@ -39,17 +39,17 @@ translation_of: Web/API/MutationObserver </table> <div class="note"> -<p><strong>Note</strong>: La cible {{domxref("Node")}} ne doit pas être confondue avec celle de <a href="https://nodejs.org/en/">NodeJS</a>.</p> +<p><strong>Note :</strong> La cible {{domxref("Node")}} ne doit pas être confondue avec celle de <a href="https://nodejs.org/en/">NodeJS</a>.</p> </div> -<h3 id="observe()" name="observe()"><code>observe()</code></h3> +<h3 id="observe()"><code>observe()</code></h3> <p>Inscrit l’instance du <code>MutationObserver</code> afin d’être notifié des mutations DOM du nœud sélectionné.</p> <pre class="syntaxbox">void observe( {{domxref("Node")}} target, <a href="#MutationObserverInit"><code>MutationObserverInit</code></a> options ); </pre> -<h6 id="Parameters" name="Parameters">Paramètres</h6> +<h4 id="Parameters">Paramètres</h4> <dl> <dt><code>target</code></dt> @@ -58,9 +58,11 @@ translation_of: Web/API/MutationObserver <dd>Un objet du type <a href="#MutationObserverInit"><code>MutationObserverInit</code></a>. Il spécifie quelles mutations DOM sont à rapporter.</dd> </dl> -<div class="note"><strong>Note :</strong> ajouter un observateur sur un élément revient à utiliser <code>addEventListener</code>. Si vous observez un élément plusieurs fois, cela n’a pas d’impact, dans le sens où, si vous observez un élément deux fois, la callback ne sera pas appelée deux fois, et vous n’aurez pas besoin d’appeler <code>disconnect()</code> deux fois. En d’autres termes, une fois qu’un élément est observé, l’observer à nouveau avec la même instance n’a pas d’effet. Cependant, si la callback est différente, un nouvel observateur sera ajouté.</div> +<div class="note"> + <p><strong>Note :</strong> ajouter un observateur sur un élément revient à utiliser <code>addEventListener</code>. Si vous observez un élément plusieurs fois, cela n’a pas d’impact, dans le sens où, si vous observez un élément deux fois, la callback ne sera pas appelée deux fois, et vous n’aurez pas besoin d’appeler <code>disconnect()</code> deux fois. En d’autres termes, une fois qu’un élément est observé, l’observer à nouveau avec la même instance n’a pas d’effet. Cependant, si la callback est différente, un nouvel observateur sera ajouté.</p> +</div> -<h3 id="disconnect()" name="disconnect()"><code>disconnect()</code></h3> +<h3 id="disconnect()"><code>disconnect()</code></h3> <p>L’instance <code>MutationObserver</code> cesse de recevoir les notifications de mutations DOM. Jusqu’à ce que la méthode <a href="#observe()"><code>observe()</code></a> soit appelée à nouveau, les callbacks de l’observateur ne seront pas invoquées.</p> @@ -68,10 +70,10 @@ translation_of: Web/API/MutationObserver </pre> <div class="note"> -<p><strong>Note : </strong>Selon la <a href="https://dom.spec.whatwg.org/#garbage-collection">spécification</a>, un <code>MutationObserver</code> est supprimé par le garbage collector si l'élément cible est supprimé.</p> +<p><strong>Note :</strong> Selon la <a href="https://dom.spec.whatwg.org/#garbage-collection">spécification</a>, un <code>MutationObserver</code> est supprimé par le garbage collector si l'élément cible est supprimé.</p> </div> -<h3 id="takeRecords()" name="takeRecords()"><code>takeRecords()</code></h3> +<h3 id="takeRecords()"><code>takeRecords()</code></h3> <p>Vide la file des mutations enregistrées du <code>MutationObserver</code> et retourne son contenu.</p> @@ -83,11 +85,13 @@ translation_of: Web/API/MutationObserver <dd>Retourne un tableau de {{domxref("MutationRecord")}}.</dd> </dl> -<h2 id="MutationObserverInit" name="MutationObserverInit"><code>MutationObserverInit</code></h2> +<h2 id="MutationObserverInit"><code>MutationObserverInit</code></h2> <p><code>MutationObserverInit</code> est un objet pouvant avoir les propriétés suivantes :</p> -<div class="note"><strong>Note :</strong> Au moins une propriété parmi <code>childList</code>, <code>attributes</code> ou <code>characterData</code> doit être initialisée à <code>true</code>, sinon l’erreur <em lang="en">"An invalid or illegal string was specified</em>" sera émise.</div> +<div class="note"> + <p><strong>Note :</strong> Au moins une propriété parmi <code>childList</code>, <code>attributes</code> ou <code>characterData</code> doit être initialisée à <code>true</code>, sinon l’erreur <i lang="en">"An invalid or illegal string was specified</i>" sera émise.</p> +</div> <table class="standard-table"> <tbody> @@ -128,7 +132,7 @@ translation_of: Web/API/MutationObserver <h2 id="Exemple_d’utilisation">Exemple d’utilisation</h2> -<p>L’exemple suivant est extrait de ce <a class="external" href="http://hacks.mozilla.org/2012/05/dom-mutationobserver-reacting-to-dom-changes-without-killing-browser-performance/" rel="freelink">blog</a>.</p> +<p>L’exemple suivant est extrait de ce <a href="http://hacks.mozilla.org/2012/05/dom-mutationobserver-reacting-to-dom-changes-without-killing-browser-performance/" rel="freelink">blog</a>.</p> <pre class="brush: js">// Selectionne le noeud dont les mutations seront observées var targetNode = document.getElementById('some-id'); @@ -157,17 +161,17 @@ observer.observe(targetNode, config); // L'observation peut être arrêtée par la suite observer.disconnect();</pre> -<h2 id="Additional_reading" name="Additional_reading">Autres articles pour en savoir plus (en anglais)</h2> +<h2 id="Additional_reading">Autres articles pour en savoir plus (en anglais)</h2> <ul> - <li><a class="external" href="http://updates.html5rocks.com/2012/02/Detect-DOM-changes-with-Mutation-Observers" rel="freelink">A brief overview</a></li> - <li><a class="external" href="http://hacks.mozilla.org/2012/05/dom-mutationobserver-reacting-to-dom-changes-without-killing-browser-performance/" rel="freelink">A more in-depth discussion</a></li> - <li><a class="external" href="http://www.youtube.com/watch?v=eRZ4pO0gVWw" rel="freelink">A screencast by Chromium developer Rafael Weinstein</a></li> - <li><a class="external" href="http://code.google.com/p/mutation-summary/" rel="freelink">The mutation summary library</a></li> + <li><a href="http://updates.html5rocks.com/2012/02/Detect-DOM-changes-with-Mutation-Observers" rel="freelink">A brief overview</a></li> + <li><a href="http://hacks.mozilla.org/2012/05/dom-mutationobserver-reacting-to-dom-changes-without-killing-browser-performance/" rel="freelink">A more in-depth discussion</a></li> + <li><a href="http://www.youtube.com/watch?v=eRZ4pO0gVWw" rel="freelink">A screencast by Chromium developer Rafael Weinstein</a></li> + <li><a href="http://code.google.com/p/mutation-summary/" rel="freelink">The mutation summary library</a></li> <li><a href="http://dom.spec.whatwg.org/#mutation-observers">The DOM standard</a> which defines the <code>MutationObserver</code> interface</li> </ul> -<h2 id="Spécifications" name="Spécifications">Spécifications</h2> +<h2 id="Spécifications">Spécifications</h2> <table class="standard-table"> <thead> |