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/nodeiterator | |
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/nodeiterator')
-rw-r--r-- | files/fr/web/api/nodeiterator/detach/index.md | 67 | ||||
-rw-r--r-- | files/fr/web/api/nodeiterator/expandentityreferences/index.md | 54 | ||||
-rw-r--r-- | files/fr/web/api/nodeiterator/filter/index.md | 56 | ||||
-rw-r--r-- | files/fr/web/api/nodeiterator/index.md | 313 | ||||
-rw-r--r-- | files/fr/web/api/nodeiterator/nextnode/index.md | 55 | ||||
-rw-r--r-- | files/fr/web/api/nodeiterator/pointerbeforereferencenode/index.md | 48 | ||||
-rw-r--r-- | files/fr/web/api/nodeiterator/previousnode/index.md | 57 | ||||
-rw-r--r-- | files/fr/web/api/nodeiterator/referencenode/index.md | 47 | ||||
-rw-r--r-- | files/fr/web/api/nodeiterator/root/index.md | 53 | ||||
-rw-r--r-- | files/fr/web/api/nodeiterator/whattoshow/index.md | 239 |
10 files changed, 441 insertions, 548 deletions
diff --git a/files/fr/web/api/nodeiterator/detach/index.md b/files/fr/web/api/nodeiterator/detach/index.md index ee558b083b..f6fa126d80 100644 --- a/files/fr/web/api/nodeiterator/detach/index.md +++ b/files/fr/web/api/nodeiterator/detach/index.md @@ -10,60 +10,39 @@ tags: - Noeuds translation_of: Web/API/NodeIterator/detach --- -<p>{{APIRef("DOM")}}{{obsolete_header}}</p> +{{APIRef("DOM")}}{{obsolete_header}} -<p>La méthode <strong><code>NodeIterator.detach()</code></strong> est une non opération, conservée seulement pour la rétro-compatibilité.</p> +La méthode **`NodeIterator.detach()`** est une non opération, conservée seulement pour la rétro-compatibilité. -<p>Initialement, elle détachait {{domxref("NodeIterator")}} de l'ensemble sur lequel il itérait, libérant toutes les ressources utilisées par lui et basculant son état à <code>INVALID</code>. Une fois cette méthode utilisée, l'appel d'autres méthodes sur le <code>NodeIterator</code> déclenchait une exception <code>INVALID_STATE_ERR</code>. </p> +Initialement, elle détachait {{domxref("NodeIterator")}} de l'ensemble sur lequel il itérait, libérant toutes les ressources utilisées par lui et basculant son état à `INVALID`. Une fois cette méthode utilisée, l'appel d'autres méthodes sur le `NodeIterator` déclenchait une exception `INVALID_STATE_ERR`. -<h2 id="Syntax">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox"><em>nodeIterator</em>.detach(); -</pre> + nodeIterator.detach(); -<h2 id="Example">Exemple</h2> +## Exemple -<pre class="eval">var nodeIterator = document.createNodeIterator( - document.body, - NodeFilter.SHOW_ELEMENT, - { acceptNode: function(node) { return NodeFilter.FILTER_ACCEPT; } }, - false -); -nodeIterator.detach(); // détache l'itérateur + var nodeIterator = document.createNodeIterator( + document.body, + NodeFilter.SHOW_ELEMENT, + { acceptNode: function(node) { return NodeFilter.FILTER_ACCEPT; } }, + false + ); + nodeIterator.detach(); // détache l'itérateur -nodeIterator.nextNode(); // lance une exception INVALID_STATE_ERR -</pre> + nodeIterator.nextNode(); // lance une exception INVALID_STATE_ERR -<h2 id="Specification">Spécifications</h2> +## Spécifications -<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-nodeiterator-detach', 'NodeIterator.detach')}}</td> - <td>{{Spec2('DOM WHATWG')}}</td> - <td>Transformation en non opération</td> - </tr> - <tr> - <td>{{SpecName('DOM2 Traversal_Range', 'traversal.html#Traversal-NodeIterator-detach', 'NodeIterator.detach')}}</td> - <td>{{Spec2('DOM2 Traversal_Range')}}</td> - <td>Définition initiale.</td> - </tr> - </tbody> -</table> +| Spécification | Statut | Commentaire | +| ------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------- | ------------------------------- | +| {{SpecName('DOM WHATWG', '#dom-nodeiterator-detach', 'NodeIterator.detach')}} | {{Spec2('DOM WHATWG')}} | Transformation en non opération | +| {{SpecName('DOM2 Traversal_Range', 'traversal.html#Traversal-NodeIterator-detach', 'NodeIterator.detach')}} | {{Spec2('DOM2 Traversal_Range')}} | Définition initiale. | -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs +{{Compat("api.NodeIterator.detach")}} +## Voir aussi -<p>{{Compat("api.NodeIterator.detach")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>L'interface à laquelle elle appartient : {{domxref("NodeIterator")}}.</li> -</ul> +- L'interface à laquelle elle appartient : {{domxref("NodeIterator")}}. diff --git a/files/fr/web/api/nodeiterator/expandentityreferences/index.md b/files/fr/web/api/nodeiterator/expandentityreferences/index.md index 32c3294fc0..974f253391 100644 --- a/files/fr/web/api/nodeiterator/expandentityreferences/index.md +++ b/files/fr/web/api/nodeiterator/expandentityreferences/index.md @@ -10,55 +10,39 @@ tags: - Propriété translation_of: Web/API/NodeIterator/expandEntityReferences --- -<p>{{APIRef("DOM")}} {{deprecated_header}}</p> +{{APIRef("DOM")}} {{deprecated_header}} -<p>La propriété en lecture seule <code><strong>NodeIterator.expandEntityReferences</strong></code> renvoie un {{domxref("Boolean")}} (<em>booléen</em>) indiquant si les enfants des noeuds de référence d'entité sont visibles ou non pour le {{domxref("NodeIterator")}}.</p> +La propriété en lecture seule **`NodeIterator.expandEntityReferences`** renvoie un {{domxref("Boolean")}} (_booléen_) indiquant si les enfants des noeuds de référence d'entité sont visibles ou non pour le {{domxref("NodeIterator")}}. -<p>Si cette valeur est <code>false</code> (<em>faux</em>), les enfants des nœuds de référence d'entité (ainsi que tous leurs descendants) sont rejetés. Cela a préséance sur la valeur de la méthode {{domxref("NodeIterator.whatToShow")}} et le filtre associé.</p> +Si cette valeur est `false` (_faux_), les enfants des nœuds de référence d'entité (ainsi que tous leurs descendants) sont rejetés. Cela a préséance sur la valeur de la méthode {{domxref("NodeIterator.whatToShow")}} et le filtre associé. -<h2 id="Syntax">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox"><em>expand</em> = <em>nodeIterator</em>.expandEntityReferences; -</pre> + expand = nodeIterator.expandEntityReferences; -<h2 id="Example">Exemple</h2> +## Exemple -<pre class="brush: js">var nodeIterator = document.createNodeIterator( +```js +var nodeIterator = document.createNodeIterator( document.body, NodeFilter.SHOW_ELEMENT, { acceptNode: function(node) { return NodeFilter.FILTER_ACCEPT; } }, false ); -expand = nodeIterator.expandEntityReferences;</pre> +expand = nodeIterator.expandEntityReferences; +``` -<h2 id="Specification">Spécifications</h2> +## Spécifications -<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', '#nodeiterator', 'NodeIterator')}}</td> - <td>{{Spec2('DOM WHATWG')}}</td> - <td>Suppression de la spécification</td> - </tr> - <tr> - <td>{{SpecName('DOM2 Traversal_Range', 'traversal.html#Traversal-NodeIterator-expandEntityReferences', 'NodeIterator.expandEntityReferences')}}</td> - <td>{{Spec2('DOM2 Traversal_Range')}}</td> - <td>Définition initiale.</td> - </tr> - </tbody> -</table> +| Spécification | Statut | Commentaire | +| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------- | ------------------------------- | +| {{SpecName('DOM WHATWG', '#nodeiterator', 'NodeIterator')}} | {{Spec2('DOM WHATWG')}} | Suppression de la spécification | +| {{SpecName('DOM2 Traversal_Range', 'traversal.html#Traversal-NodeIterator-expandEntityReferences', 'NodeIterator.expandEntityReferences')}} | {{Spec2('DOM2 Traversal_Range')}} | Définition initiale. | -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs -<p>{{Compat("api.NodeIterator.expandEntityReferences")}}</p> +{{Compat("api.NodeIterator.expandEntityReferences")}} -<h2 id="Voir_aussi">Voir aussi</h2> +## Voir aussi -<ul> - <li>L'interface à laquelle cette propriété appartient : {{domxref("NodeIterator")}}.</li> -</ul> +- L'interface à laquelle cette propriété appartient : {{domxref("NodeIterator")}}. diff --git a/files/fr/web/api/nodeiterator/filter/index.md b/files/fr/web/api/nodeiterator/filter/index.md index 57cbd54740..0ead217d82 100644 --- a/files/fr/web/api/nodeiterator/filter/index.md +++ b/files/fr/web/api/nodeiterator/filter/index.md @@ -10,57 +10,39 @@ tags: - Propriétés translation_of: Web/API/NodeIterator/filter --- -<div>{{APIRef("DOM")}}</div> +{{APIRef("DOM")}} -<p>La méthode en lecture seule <strong><code>NodeIterator.filter</code></strong> renvoie un objet {{domxref("NodeFilter")}}, c'est-à-dire un objet implémentant la méthode <code>acceptNode(<em>node</em>)</code>, utilisée pour filtrer les noeuds.</p> +La méthode en lecture seule **`NodeIterator.filter`** renvoie un objet {{domxref("NodeFilter")}}, c'est-à-dire un objet implémentant la méthode `acceptNode(node)`, utilisée pour filtrer les noeuds. -<p>Lors de la création du {{domxref("NodeIterator")}}, l'objet filtre est transmis en 3ème paramètre et l'objet méthode <code>acceptNode(<em>node</em>)</code> est appelé sur chaque noeud pour déterminer s'il doit ou non l'accepter. Cette fonction doit renvoyer la constante <code>NodeFilter.FILTER_ACCEPT</code> quand le noeud doit être accepté et <code>NodeFilter.FILTER_REJECT</code> s'il doit être rejeté.</p> +Lors de la création du {{domxref("NodeIterator")}}, l'objet filtre est transmis en 3ème paramètre et l'objet méthode `acceptNode(node)` est appelé sur chaque noeud pour déterminer s'il doit ou non l'accepter. Cette fonction doit renvoyer la constante `NodeFilter.FILTER_ACCEPT` quand le noeud doit être accepté et `NodeFilter.FILTER_REJECT` s'il doit être rejeté. -<h2 id="Syntax">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox"><em>nodeFilter</em> = <em>nodeIterator</em>.filter; -</pre> + nodeFilter = nodeIterator.filter; -<h2 id="Example">Exemple</h2> +## Exemple -<pre class="brush: js">var nodeIterator = document.createNodeIterator( +```js +var nodeIterator = document.createNodeIterator( document.body, NodeFilter.SHOW_ELEMENT, { acceptNode: function(node) { return NodeFilter.FILTER_ACCEPT; } }, false ); -nodeFilter = nodeIterator.filter;</pre> +nodeFilter = nodeIterator.filter; +``` -<h2 id="Spécifications">Spécifications</h2> +## Spécifications -<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-nodeiterator-filter', 'NodeIterator.filter')}}</td> - <td>{{Spec2('DOM WHATWG')}}</td> - <td>Pas de changement de {{SpecName('DOM2 Traversal_Range')}}.</td> - </tr> - <tr> - <td>{{SpecName('DOM2 Traversal_Range', 'traversal.html#Traversal-NodeIterator-filter', 'NodeIterator.filter')}}</td> - <td>{{Spec2('DOM2 Traversal_Range')}}</td> - <td>Définition initiale.</td> - </tr> - </tbody> -</table> +| Spécification | Statut | Commentaire | +| ------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------- | ---------------------------------------------------------------------- | +| {{SpecName('DOM WHATWG', '#dom-nodeiterator-filter', 'NodeIterator.filter')}} | {{Spec2('DOM WHATWG')}} | Pas de changement de {{SpecName('DOM2 Traversal_Range')}}. | +| {{SpecName('DOM2 Traversal_Range', 'traversal.html#Traversal-NodeIterator-filter', 'NodeIterator.filter')}} | {{Spec2('DOM2 Traversal_Range')}} | Définition initiale. | -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs +{{Compat("api.NodeIterator.filter")}} +## Voir aussi -<p>{{Compat("api.NodeIterator.filter")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>L'interface à laquelle cette propriété appartient : {{domxref("NodeIterator")}}.</li> -</ul> +- L'interface à laquelle cette propriété appartient : {{domxref("NodeIterator")}}. diff --git a/files/fr/web/api/nodeiterator/index.md b/files/fr/web/api/nodeiterator/index.md index d45bd86f1f..e38aed5afe 100644 --- a/files/fr/web/api/nodeiterator/index.md +++ b/files/fr/web/api/nodeiterator/index.md @@ -8,153 +8,166 @@ tags: - Noeuds translation_of: Web/API/NodeIterator --- -<div>{{APIRef("DOM")}}</div> - -<p>L'interface <strong><code>NodeIterator</code></strong> représente un itérateur pour les membres d'une liste des nœuds dans un sous-arbre du DOM. Les nœuds seront renvoyés dans l'ordre du document.</p> - -<p>Un <code>NodeIterator</code> peut être créé en utilisant la méthode {{domxref("Document.createNodeIterator()")}}, comme suit :</p> - -<pre class="brush: js">var nodeIterator = document.createNodeIterator(<em>root</em>, <em>whatToShow</em>, <em>filter</em>);</pre> - -<h2 id="Properties">Propriétés</h2> - -<p><em>L'interface n'hérite d'aucune propriété.</em></p> - -<dl> - <dt>{{domxref("NodeIterator.root")}} {{readonlyInline}}</dt> - <dd>Renvoie un {{domxref("Node")}} (<em>noeud</em>) représentant le noeud racine comme spécifié lors de la création du <code>NodeIterator</code>.</dd> - <dt>{{domxref("NodeIterator.whatToShow")}} {{readonlyInline}}</dt> - <dd>Renvoie un <code>unsigned long</code> (<em>long non signé</em>), celui-ci étant un masque constitué de constantes décrivant les types de {{domxref("Node")}} (<em>noeud</em>) et devant être présenté. Les nœuds non correspondants sont ignorés, mais leurs enfants peuvent être inclus, le cas échéant. Les valeurs possibles sont : - <table class="standard-table"> - <tbody> - <tr> - <td class="header">Constante</td> - <td class="header">Valeur numérique</td> - <td class="header">Description</td> - </tr> - <tr> - <td><code>NodeFilter.SHOW_ALL</code></td> - <td><code>-1</code> (c'est la valeur numérique maximale du <code>unsigned long</code> (<em>non signé long</em>))</td> - <td>Affiche tous les noeuds.</td> - </tr> - <tr> - <td><code>NodeFilter.SHOW_ATTRIBUTE</code> {{obsolete_inline}}</td> - <td><code>2</code></td> - <td>Affiche l'attribut {{domxref("Attr")}} des noeuds. Cela n'a de sens que lors de la création d'un {{domxref("TreeWalker")}} avec un noeud {{domxref("Attr")}} comme racine ; dans ce cas, cela signifie que le nœud d'attribut apparaîtra dans la première position de l'itération ou de la traversée. Comme les attributs ne sont jamais des enfants d'autres nœuds, ils n'apparaissent pas lors de la traversée de l'arbre du document.</td> - </tr> - <tr> - <td><code>NodeFilter.SHOW_CDATA_SECTION</code> {{obsolete_inline}}</td> - <td><code>8</code></td> - <td>Affiche les noeuds {{domxref("CDATASection")}}.</td> - </tr> - <tr> - <td><code>NodeFilter.SHOW_COMMENT</code></td> - <td><code>128</code></td> - <td>Affiche les noeuds {{domxref("Comment")}}.</td> - </tr> - <tr> - <td><code>NodeFilter.SHOW_DOCUMENT</code></td> - <td><code>256</code></td> - <td>Affiche les noeuds {{domxref("Document")}}.</td> - </tr> - <tr> - <td><code>NodeFilter.SHOW_DOCUMENT_FRAGMENT</code></td> - <td><code>1024</code></td> - <td>Affiche les noeuds {{domxref("DocumentFragment")}}.</td> - </tr> - <tr> - <td><code>NodeFilter.SHOW_DOCUMENT_TYPE</code></td> - <td><code>512</code></td> - <td>Affiche les noeuds {{domxref("DocumentType")}}.</td> - </tr> - <tr> - <td><code>NodeFilter.SHOW_ELEMENT</code></td> - <td><code>1</code></td> - <td>Affiche les noeuds {{domxref("Element")}}.</td> - </tr> - <tr> - <td><code>NodeFilter.SHOW_ENTITY</code> {{obsolete_inline}}</td> - <td><code>32</code></td> - <td>Affiche les noeuds {{domxref("Entity")}}. Cela n'a de sens que lors de la création d'un {{domxref("TreeWalker")}} avec un noeud {{ domxref("Entity") }} comme racine ; dans ce cas, il signifie que le noeud d'entité {{domxref("Entity") }} apparaîtra à la première position de la traversée. Étant donné que les entités ne font pas partie de l'arborescence du document, elles n'apparaissent pas lors de la traversée de l'arborescence du document.</td> - </tr> - <tr> - <td><code>NodeFilter.SHOW_ENTITY_REFERENCE</code> {{obsolete_inline}}</td> - <td><code>16</code></td> - <td>Affiche les noeuds {{domxref("EntityReference")}}.</td> - </tr> - <tr> - <td><code>NodeFilter.SHOW_NOTATION</code> {{obsolete_inline}}</td> - <td><code>2048</code></td> - <td>Affiche les noeuds {{domxref("Notation")}}. Cela n'a de sens que lors de la création d'un {{domxref("TreeWalker")}} avec un noeud {{domxref("Notation")}} comme racine ; dans ce cas, il signifie que le noeud {{domxref("Notation")}} apparaîtra à la première position de la traversée. Étant donné que les entités ne font pas partie de l'arborescence du document, elles n'apparaissent pas lors de la traversée de l'arborescence du document.</td> - </tr> - <tr> - <td><code>NodeFilter.SHOW_PROCESSING_INSTRUCTION</code></td> - <td><code>64</code></td> - <td>Affiche les noeuds {{domxref("ProcessingInstruction")}}.</td> - </tr> - <tr> - <td><code>NodeFilter.SHOW_TEXT</code></td> - <td><code>4</code></td> - <td>Affiche les noeuds {{domxref("Text")}}.</td> - </tr> - </tbody> - </table> - </dd> - <dt>{{domxref("NodeIterator.filter")}} {{readonlyInline}}</dt> - <dd>Renvoie un {{domxref("NodeFilter")}} utilisé pour sélectionner les noeuds pertinents.</dd> - <dt>{{domxref("NodeIterator.expandEntityReferences")}} {{readonlyInline}} {{deprecated_inline}}</dt> - <dd>est un {{domxref("Boolean")}} (<em>booléen</em>) indiquant si, lors de la suppression d'une {{domxref("EntityReference")}}, tout son sous-arbre doit être supprimé en même temps.</dd> - <dt>{{domxref("NodeIterator.referenceNode")}} {{readonlyInline}} {{experimental_inline() }}</dt> - <dd>Renvoie le {{domxref("Node")}} (noeud) auquel l'itérateur est ancré.</dd> - <dt>{{domxref("NodeIterator.pointerBeforeReferenceNode")}} {{readonlyInline}} {{ experimental_inline() }}</dt> - <dd>Renvoie un {{domxref("Boolean")}} (<em>booléen</em>) qui indique si le {{domxref("NodeIterator")}} est ancré avant (<code>true</code> (<em>vrai</em>)) ou après (<code>false</code> (<em>faux</em>)) le noeud d'ancrage.</dd> -</dl> - -<h2 id="Methods">Méthodes</h2> - -<p><em>Cette interface n'hérite d'aucune méthode.</em></p> - -<dl> - <dt>{{domxref("NodeIterator.detach()")}} {{obsolete_inline()}}</dt> - <dd>Cette opération est une non opération. Elle ne fait rien. Auparavant, elle disait au moteur que le <code>NodeIterator</code> n'était plus utilisé, mais c'est maintenant inutile.</dd> - <dt>{{domxref("NodeIterator.previousNode()")}}</dt> - <dd>Renvoie le noeud {{domxref("Node")}} précédent dans le document ou <code>null</code> s'il n'y en a aucun.</dd> - <dt>{{domxref("NodeIterator.nextNode()")}}</dt> - <dd>Renvoie le noeud {{domxref("Node")}} suivant dans le document ou <code>null</code> s'il n'y en a aucun.</dd> -</dl> - -<h2 id="Specification">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', '#nodeiterator', 'NodeIterator')}}</td> - <td>{{Spec2('DOM WHATWG')}}</td> - <td>Ajout des propriétés <code>referenceNode</code> et <code>pointerBeforeReferenceNode</code>.<br> - Suppression de la propriété <code>expandEntityReferences</code>.<br> - La méthode <code>detach()</code> a été modifiée pour être une non opération.<br> - Les méthodes <code>previousNode()</code> et <code>nextNode()</code> ne déclenchent plus d'exceptions.</td> - </tr> - <tr> - <td>{{SpecName('DOM2 Traversal_Range', 'traversal.html#Iterator-overview', 'NodeIterator')}}</td> - <td>{{Spec2('DOM2 Traversal_Range')}}</td> - <td>Définition initiale.</td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<p>{{Compat("api.NodeIterator")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>La méthode de création : {{domxref("Document.createNodeIterator()")}}.</li> - <li>Interfaces connexes : {{domxref("NodeFilter")}}, {{domxref("TreeWalker")}}.</li> -</ul> +{{APIRef("DOM")}} + +L'interface **`NodeIterator`** représente un itérateur pour les membres d'une liste des nœuds dans un sous-arbre du DOM. Les nœuds seront renvoyés dans l'ordre du document. + +Un `NodeIterator` peut être créé en utilisant la méthode {{domxref("Document.createNodeIterator()")}}, comme suit : + +```js +var nodeIterator = document.createNodeIterator(root, whatToShow, filter); +``` + +## Propriétés + +_L'interface n'hérite d'aucune propriété._ + +- {{domxref("NodeIterator.root")}} {{readonlyInline}} + - : Renvoie un {{domxref("Node")}} (_noeud_) représentant le noeud racine comme spécifié lors de la création du `NodeIterator`. +- {{domxref("NodeIterator.whatToShow")}} {{readonlyInline}} + + - : Renvoie un `unsigned long` (_long non signé_), celui-ci étant un masque constitué de constantes décrivant les types de {{domxref("Node")}} (_noeud_) et devant être présenté. Les nœuds non correspondants sont ignorés, mais leurs enfants peuvent être inclus, le cas échéant. Les valeurs possibles sont : + + <table class="standard-table"> + <tbody> + <tr> + <td class="header">Constante</td> + <td class="header">Valeur numérique</td> + <td class="header">Description</td> + </tr> + <tr> + <td><code>NodeFilter.SHOW_ALL</code></td> + <td> + <code>-1</code> (c'est la valeur numérique maximale du + <code>unsigned long</code> (<em>non signé long</em>)) + </td> + <td>Affiche tous les noeuds.</td> + </tr> + <tr> + <td><code>NodeFilter.SHOW_ATTRIBUTE</code> {{obsolete_inline}}</td> + <td><code>2</code></td> + <td> + Affiche l'attribut {{domxref("Attr")}} des noeuds. Cela n'a de sens + que lors de la création d'un {{domxref("TreeWalker")}} avec un + noeud {{domxref("Attr")}} comme racine ; dans ce cas, cela signifie + que le nœud d'attribut apparaîtra dans la première position de + l'itération ou de la traversée. Comme les attributs ne sont jamais des + enfants d'autres nœuds, ils n'apparaissent pas lors de la traversée de + l'arbre du document. + </td> + </tr> + <tr> + <td> + <code>NodeFilter.SHOW_CDATA_SECTION</code> {{obsolete_inline}} + </td> + <td><code>8</code></td> + <td>Affiche les noeuds {{domxref("CDATASection")}}.</td> + </tr> + <tr> + <td><code>NodeFilter.SHOW_COMMENT</code></td> + <td><code>128</code></td> + <td>Affiche les noeuds {{domxref("Comment")}}.</td> + </tr> + <tr> + <td><code>NodeFilter.SHOW_DOCUMENT</code></td> + <td><code>256</code></td> + <td>Affiche les noeuds {{domxref("Document")}}.</td> + </tr> + <tr> + <td><code>NodeFilter.SHOW_DOCUMENT_FRAGMENT</code></td> + <td><code>1024</code></td> + <td>Affiche les noeuds {{domxref("DocumentFragment")}}.</td> + </tr> + <tr> + <td><code>NodeFilter.SHOW_DOCUMENT_TYPE</code></td> + <td><code>512</code></td> + <td>Affiche les noeuds {{domxref("DocumentType")}}.</td> + </tr> + <tr> + <td><code>NodeFilter.SHOW_ELEMENT</code></td> + <td><code>1</code></td> + <td>Affiche les noeuds {{domxref("Element")}}.</td> + </tr> + <tr> + <td><code>NodeFilter.SHOW_ENTITY</code> {{obsolete_inline}}</td> + <td><code>32</code></td> + <td> + Affiche les noeuds {{domxref("Entity")}}. Cela n'a de sens que + lors de la création d'un {{domxref("TreeWalker")}} avec un noeud + {{ domxref("Entity") }} comme racine ; dans ce cas, il signifie + que le noeud d'entité {{domxref("Entity") }} apparaîtra à la + première position de la traversée. Étant donné que les entités ne font + pas partie de l'arborescence du document, elles n'apparaissent pas lors + de la traversée de l'arborescence du document. + </td> + </tr> + <tr> + <td> + <code>NodeFilter.SHOW_ENTITY_REFERENCE</code> {{obsolete_inline}} + </td> + <td><code>16</code></td> + <td>Affiche les noeuds {{domxref("EntityReference")}}.</td> + </tr> + <tr> + <td><code>NodeFilter.SHOW_NOTATION</code> {{obsolete_inline}}</td> + <td><code>2048</code></td> + <td> + Affiche les noeuds {{domxref("Notation")}}. Cela n'a de sens + que lors de la création d'un {{domxref("TreeWalker")}} avec un + noeud {{domxref("Notation")}} comme racine ; dans ce cas, il + signifie que le noeud {{domxref("Notation")}} apparaîtra à la + première position de la traversée. Étant donné que les entités ne font + pas partie de l'arborescence du document, elles n'apparaissent pas lors + de la traversée de l'arborescence du document. + </td> + </tr> + <tr> + <td><code>NodeFilter.SHOW_PROCESSING_INSTRUCTION</code></td> + <td><code>64</code></td> + <td> + Affiche les noeuds {{domxref("ProcessingInstruction")}}. + </td> + </tr> + <tr> + <td><code>NodeFilter.SHOW_TEXT</code></td> + <td><code>4</code></td> + <td>Affiche les noeuds {{domxref("Text")}}.</td> + </tr> + </tbody> + </table> + +- {{domxref("NodeIterator.filter")}} {{readonlyInline}} + - : Renvoie un {{domxref("NodeFilter")}} utilisé pour sélectionner les noeuds pertinents. +- {{domxref("NodeIterator.expandEntityReferences")}} {{readonlyInline}} {{deprecated_inline}} + - : est un {{domxref("Boolean")}} (_booléen_) indiquant si, lors de la suppression d'une {{domxref("EntityReference")}}, tout son sous-arbre doit être supprimé en même temps. +- {{domxref("NodeIterator.referenceNode")}} {{readonlyInline}} {{experimental_inline() }} + - : Renvoie le {{domxref("Node")}} (noeud) auquel l'itérateur est ancré. +- {{domxref("NodeIterator.pointerBeforeReferenceNode")}} {{readonlyInline}} {{ experimental_inline() }} + - : Renvoie un {{domxref("Boolean")}} (_booléen_) qui indique si le {{domxref("NodeIterator")}} est ancré avant (`true` (_vrai_)) ou après (`false` (_faux_)) le noeud d'ancrage. + +## Méthodes + +_Cette interface n'hérite d'aucune méthode._ + +- {{domxref("NodeIterator.detach()")}} {{obsolete_inline()}} + - : Cette opération est une non opération. Elle ne fait rien. Auparavant, elle disait au moteur que le `NodeIterator` n'était plus utilisé, mais c'est maintenant inutile. +- {{domxref("NodeIterator.previousNode()")}} + - : Renvoie le noeud {{domxref("Node")}} précédent dans le document ou `null` s'il n'y en a aucun. +- {{domxref("NodeIterator.nextNode()")}} + - : Renvoie le noeud {{domxref("Node")}} suivant dans le document ou `null` s'il n'y en a aucun. + +## Spécifications + +| Spécification | Statut | Commentaire | +| -------------------------------------------------------------------------------------------------------------------- | -------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| {{SpecName('DOM WHATWG', '#nodeiterator', 'NodeIterator')}} | {{Spec2('DOM WHATWG')}} | Ajout des propriétés `referenceNode` et `pointerBeforeReferenceNode`. Suppression de la propriété `expandEntityReferences`. La méthode `detach()` a été modifiée pour être une non opération. Les méthodes `previousNode()` et `nextNode()` ne déclenchent plus d'exceptions. | +| {{SpecName('DOM2 Traversal_Range', 'traversal.html#Iterator-overview', 'NodeIterator')}} | {{Spec2('DOM2 Traversal_Range')}} | Définition initiale. | + +## Compatibilité des navigateurs + +{{Compat("api.NodeIterator")}} + +## Voir aussi + +- La méthode de création : {{domxref("Document.createNodeIterator()")}}. +- Interfaces connexes : {{domxref("NodeFilter")}}, {{domxref("TreeWalker")}}. diff --git a/files/fr/web/api/nodeiterator/nextnode/index.md b/files/fr/web/api/nodeiterator/nextnode/index.md index 517cc65cef..ff4676c9fb 100644 --- a/files/fr/web/api/nodeiterator/nextnode/index.md +++ b/files/fr/web/api/nodeiterator/nextnode/index.md @@ -10,58 +10,41 @@ tags: - Noeuds translation_of: Web/API/NodeIterator/nextNode --- -<div>{{APIRef("DOM")}}</div> +{{APIRef("DOM")}} -<p>La méthode <code><strong>NodeIterator.nextNode()</strong></code> renvoie le noeud suivant dans l'ensemble représenté par le {{domxref("NodeIterator")}} et avance la position de l'itérateur dans cet ensemble. Le premier appel de <code>nextNode()</code> en renvoie le premier noeud.</p> +La méthode **`NodeIterator.nextNode()`** renvoie le noeud suivant dans l'ensemble représenté par le {{domxref("NodeIterator")}} et avance la position de l'itérateur dans cet ensemble. Le premier appel de `nextNode()` en renvoie le premier noeud. -<p>Cette méthode retourne <code>null</code> quand il n'y a plus de nœuds dans l'ensemble.</p> +Cette méthode retourne `null` quand il n'y a plus de nœuds dans l'ensemble. -<p>Dans les navigateurs anciens, comme spécifié dans les anciennes version des spécifications, la méthode pouvait déclencher une {{domxref("DOMException")}} <code>INVALID_STATE_ERR</code> si elle était appelée après la méthode {{domxref("NodeIterator.detach()")}}. Les navigateurs récents ne lancent rien.</p> +Dans les navigateurs anciens, comme spécifié dans les anciennes version des spécifications, la méthode pouvait déclencher une {{domxref("DOMException")}} `INVALID_STATE_ERR` si elle était appelée après la méthode {{domxref("NodeIterator.detach()")}}. Les navigateurs récents ne lancent rien. -<h2 id="Syntax">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox"><em>node</em> = <em>nodeIterator</em>.nextNode(); -</pre> + node = nodeIterator.nextNode(); -<h2 id="Example">Exemple</h2> +## Exemple -<pre class="brush: js">var nodeIterator = document.createNodeIterator( +```js +var nodeIterator = document.createNodeIterator( document.body, NodeFilter.SHOW_ELEMENT, { acceptNode: function(node) { return NodeFilter.FILTER_ACCEPT; } }, false // this optional argument is not used any more ); currentNode = nodeIterator.nextNode(); // renvoie le noeud suivant. -</pre> +``` -<h2 id="Specification">Spécifications</h2> +## Spécifications -<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-nodeiterator-nextnode', 'NodeIterator.nextNode')}}</td> - <td>{{Spec2('DOM WHATWG')}}</td> - <td>Comme <code>detach()</code> est maintenant une méthode non opérante, cette méthode ne peut plus rien lancer.</td> - </tr> - <tr> - <td>{{SpecName('DOM2 Traversal_Range', 'traversal.html#Traversal-NodeIterator-nextNode', 'NodeIterator.nextNode')}}</td> - <td>{{Spec2('DOM2 Traversal_Range')}}</td> - <td>Définition initiale.</td> - </tr> - </tbody> -</table> +| Spécification | Statut | Commentaire | +| ---------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------- | ------------------------------------------------------------------------------------------------- | +| {{SpecName('DOM WHATWG', '#dom-nodeiterator-nextnode', 'NodeIterator.nextNode')}} | {{Spec2('DOM WHATWG')}} | Comme `detach()` est maintenant une méthode non opérante, cette méthode ne peut plus rien lancer. | +| {{SpecName('DOM2 Traversal_Range', 'traversal.html#Traversal-NodeIterator-nextNode', 'NodeIterator.nextNode')}} | {{Spec2('DOM2 Traversal_Range')}} | Définition initiale. | -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs +{{Compat("api.NodeIterator.nextNode")}} +## Voir aussi -<p>{{Compat("api.NodeIterator.nextNode")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<p>L'interface à laquelle elle appartient : {{domxref("NodeIterator")}}.</p> +L'interface à laquelle elle appartient : {{domxref("NodeIterator")}}. diff --git a/files/fr/web/api/nodeiterator/pointerbeforereferencenode/index.md b/files/fr/web/api/nodeiterator/pointerbeforereferencenode/index.md index a2d6507e4f..d5797b5e28 100644 --- a/files/fr/web/api/nodeiterator/pointerbeforereferencenode/index.md +++ b/files/fr/web/api/nodeiterator/pointerbeforereferencenode/index.md @@ -10,50 +10,36 @@ tags: - Propriétés translation_of: Web/API/NodeIterator/pointerBeforeReferenceNode --- -<p>{{APIRef("DOM")}} {{SeeCompatTable}}</p> +{{APIRef("DOM")}} {{SeeCompatTable}} -<p>La propriété en lecture seule <strong><code>NodeIterator.pointerBeforeReferenceNode</code></strong> renvoie un {{domxref("Boolean")}} (booléen) qui indique si le {{domxref("NodeFilter")}} est ancré avant (si la valeur est <code>true</code> (<em>vrai</em>)) ou après (<code>false</code> (<em>faux</em>)) le noeud-ancre indiqué par la propriété {{domxref("NodeIterator.referenceNode")}}.</p> +La propriété en lecture seule **`NodeIterator.pointerBeforeReferenceNode`** renvoie un {{domxref("Boolean")}} (booléen) qui indique si le {{domxref("NodeFilter")}} est ancré avant (si la valeur est `true` (_vrai_)) ou après (`false` (_faux_)) le noeud-ancre indiqué par la propriété {{domxref("NodeIterator.referenceNode")}}. -<h2 id="Syntax">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox"><em>flag</em> = <em>nodeIterator</em>.pointerBeforeReferenceNode; -</pre> + flag = nodeIterator.pointerBeforeReferenceNode; -<h2 id="Example">Exemple</h2> +## Exemple -<pre class="brush: js">var nodeIterator = document.createNodeIterator( +```js +var nodeIterator = document.createNodeIterator( document.body, NodeFilter.SHOW_ELEMENT, { acceptNode: function(node) { return NodeFilter.FILTER_ACCEPT; } }, false ); -flag = nodeIterator.pointerBeforeReferenceNode;</pre> +flag = nodeIterator.pointerBeforeReferenceNode; +``` -<h2 id="Specification">Spécifications</h2> +## Spécifications -<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-nodeiterator-pointerbeforereferencenode', 'NodeIterator.pointerBeforeReferenceNode')}}</td> - <td>{{Spec2('DOM WHATWG')}}</td> - <td>Définition initiale.</td> - </tr> - </tbody> -</table> +| Spécification | Statut | Commentaire | +| ------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------- | -------------------- | +| {{SpecName('DOM WHATWG', '#dom-nodeiterator-pointerbeforereferencenode', 'NodeIterator.pointerBeforeReferenceNode')}} | {{Spec2('DOM WHATWG')}} | Définition initiale. | -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs +{{Compat("api.NodeIterator.pointerBeforeReferenceNode")}} +## Voir aussi -<p>{{Compat("api.NodeIterator.pointerBeforeReferenceNode")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>L'interface à laquelle elle appartient : {{domxref("NodeIterator")}}</li> -</ul> +- L'interface à laquelle elle appartient : {{domxref("NodeIterator")}} diff --git a/files/fr/web/api/nodeiterator/previousnode/index.md b/files/fr/web/api/nodeiterator/previousnode/index.md index e6c19c0c07..a5b45200a6 100644 --- a/files/fr/web/api/nodeiterator/previousnode/index.md +++ b/files/fr/web/api/nodeiterator/previousnode/index.md @@ -9,22 +9,22 @@ tags: - Noeuds translation_of: Web/API/NodeIterator/previousNode --- -<div>{{APIRef("DOM")}}</div> +{{APIRef("DOM")}} -<p>La méthode <code><strong>NodeIterator.previousNode()</strong></code> renvoie le noeud précédent dans l'ensemble représenté par le {{domxref("NodeIterator")}} et déplace la position de l'itérateur vers l'arrière à l'intérieur de cet ensemble.</p> +La méthode **`NodeIterator.previousNode()`** renvoie le noeud précédent dans l'ensemble représenté par le {{domxref("NodeIterator")}} et déplace la position de l'itérateur vers l'arrière à l'intérieur de cet ensemble. -<p>Cette méthode renvoie <code>null</code> si le noeud courant est le premier noeud dans l'ensemble.</p> +Cette méthode renvoie `null` si le noeud courant est le premier noeud dans l'ensemble. -<p>Dans les navigateurs anciens, comme spécifié dans les anciennes version des spécifications, la méthode pouvait déclencher une <code>INVALID_STATE_ERR</code> {{domxref("DOMException")}} si elle était appelée après la méthode {{domxref("NodeIterator.detach()")}}. Les navigateurs récents ne lancent rien.</p> +Dans les navigateurs anciens, comme spécifié dans les anciennes version des spécifications, la méthode pouvait déclencher une `INVALID_STATE_ERR` {{domxref("DOMException")}} si elle était appelée après la méthode {{domxref("NodeIterator.detach()")}}. Les navigateurs récents ne lancent rien. -<h2 id="Syntax">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox"><em>node</em> = <em>nodeIterator</em>.previousNode(); -</pre> + node = nodeIterator.previousNode(); -<h2 id="Example">Exemple</h2> +## Exemple -<pre class="brush: js">var nodeIterator = document.createNodeIterator( +```js +var nodeIterator = document.createNodeIterator( document.body, NodeFilter.SHOW_ELEMENT, { acceptNode: function(node) { return NodeFilter.FILTER_ACCEPT; } }, @@ -32,38 +32,19 @@ translation_of: Web/API/NodeIterator/previousNode ); currentNode = nodeIterator.nextNode(); // renvoie le noeud suivant previousNode = nodeIterator.previousNode(); // même résultat, puisque nous sommes retournés au noeud précédent -</pre> +``` -<h2 id="Specification">Spécifications</h2> +## Spécifications -<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-nodeiterator-previousnode', 'NodeIterator.previousNode')}}</td> - <td>{{Spec2('DOM WHATWG')}}</td> - <td>Comme <code>detach()</code> est maintenant une méthode non opérante, cette méthode ne peut plus rien lancer.</td> - </tr> - <tr> - <td>{{SpecName('DOM2 Traversal_Range', 'traversal.html#Traversal-NodeIterator-previousNode', 'NodeIterator.previousNode')}}</td> - <td>{{Spec2('DOM2 Traversal_Range')}}</td> - <td>Définition initiale.</td> - </tr> - </tbody> -</table> +| Spécification | Statut | Commentaire | +| ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------- | ------------------------------------------------------------------------------------------------- | +| {{SpecName('DOM WHATWG', '#dom-nodeiterator-previousnode', 'NodeIterator.previousNode')}} | {{Spec2('DOM WHATWG')}} | Comme `detach()` est maintenant une méthode non opérante, cette méthode ne peut plus rien lancer. | +| {{SpecName('DOM2 Traversal_Range', 'traversal.html#Traversal-NodeIterator-previousNode', 'NodeIterator.previousNode')}} | {{Spec2('DOM2 Traversal_Range')}} | Définition initiale. | -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs +{{Compat("api.NodeIterator.previousNode")}} +## Voir aussi -<p>{{Compat("api.NodeIterator.previousNode")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>L'interface à laquelle elle appartient : {{domxref("NodeIterator")}}.</li> -</ul> +- L'interface à laquelle elle appartient : {{domxref("NodeIterator")}}. diff --git a/files/fr/web/api/nodeiterator/referencenode/index.md b/files/fr/web/api/nodeiterator/referencenode/index.md index b706873866..212c1f6643 100644 --- a/files/fr/web/api/nodeiterator/referencenode/index.md +++ b/files/fr/web/api/nodeiterator/referencenode/index.md @@ -10,51 +10,36 @@ tags: - Propriétés translation_of: Web/API/NodeIterator/referenceNode --- -<p>{{APIRef("DOM")}}{{ SeeCompatTable }}</p> +{{APIRef("DOM")}}{{ SeeCompatTable }} -<p>La propriété en lecture seule <strong><code>NodeIterator.referenceNode</code></strong> renvoie le {{domxref("Node")}} auquel l'itérateur est ancré ; si de nouveaux noeuds sont insérés, l'itérateur reste ancré au noeud de référence spécifié par cette propriété.</p> +La propriété en lecture seule **`NodeIterator.referenceNode`** renvoie le {{domxref("Node")}} auquel l'itérateur est ancré ; si de nouveaux noeuds sont insérés, l'itérateur reste ancré au noeud de référence spécifié par cette propriété. -<h2 id="Syntax">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox"><em>node</em> = <em>nodeIterator</em>.referenceNode; -</pre> + node = nodeIterator.referenceNode; -<h2 id="Example">Exemple</h2> +## Exemple -<pre class="brush: js">var nodeIterator = document.createNodeIterator( +```js +var nodeIterator = document.createNodeIterator( document.body, NodeFilter.SHOW_ELEMENT, { acceptNode: function(node) { return NodeFilter.FILTER_ACCEPT; } }, false ); node = nodeIterator.referenceNode; -</pre> +``` -<h2 id="Specification">Spécifications</h2> +## Spécifications -<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-nodeiterator-referencenode', 'NodeIterator.referenceNode')}}</td> - <td>{{Spec2('DOM WHATWG')}}</td> - <td>Définition initiale.</td> - </tr> - </tbody> -</table> +| Spécification | Statut | Commentaire | +| ------------------------------------------------------------------------------------------------------------------------ | -------------------------------- | -------------------- | +| {{SpecName('DOM WHATWG', '#dom-nodeiterator-referencenode', 'NodeIterator.referenceNode')}} | {{Spec2('DOM WHATWG')}} | Définition initiale. | -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs +{{Compat("api.NodeIterator.referenceNode")}} +## Voir aussi -<p>{{Compat("api.NodeIterator.referenceNode")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>L'interface à laquelle elle appartient : {{domxref("NodeIterator")}}</li> -</ul> +- L'interface à laquelle elle appartient : {{domxref("NodeIterator")}} diff --git a/files/fr/web/api/nodeiterator/root/index.md b/files/fr/web/api/nodeiterator/root/index.md index c3fcbf3a8b..9c0416d089 100644 --- a/files/fr/web/api/nodeiterator/root/index.md +++ b/files/fr/web/api/nodeiterator/root/index.md @@ -10,56 +10,37 @@ tags: - Propriété translation_of: Web/API/NodeIterator/root --- -<div>{{APIRef("DOM")}}</div> +{{APIRef("DOM")}} -<p>La propriété en lecture seule <code><strong>NodeIterator.root</strong></code> représente le {{DOMxref("Node")}} qui est la racine de ce que le {{DOMxref("NodeIterator")}} traverse.</p> +La propriété en lecture seule **`NodeIterator.root`** représente le {{DOMxref("Node")}} qui est la racine de ce que le {{DOMxref("NodeIterator")}} traverse. -<h2 id="Syntax">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox"><em>root</em> = <em>nodeIterator</em>.root; -</pre> + root = nodeIterator.root; -<h2 id="Example">Exemple</h2> +## Exemple -<pre class="brush: js">var nodeIterator = document.createNodeIterator( +```js +var nodeIterator = document.createNodeIterator( document.body, NodeFilter.SHOW_ELEMENT, { acceptNode: function(node) { return NodeFilter.FILTER_ACCEPT; } }, false ); root = nodeIterator.root; // document.body dans ce cas -</pre> +``` -<h2 id="Specification">Spécifications</h2> +## Spécifications -<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-nodeiterator-root', 'NodeIterator.root')}}</td> - <td>{{Spec2('DOM WHATWG')}}</td> - <td>Pas de changement de {{SpecName('DOM2 Traversal_Range')}}.</td> - </tr> - <tr> - <td>{{SpecName('DOM2 Traversal_Range', 'traversal.html#Traversal-NodeIterator-root', 'NodeIterator.root')}}</td> - <td>{{Spec2('DOM2 Traversal_Range')}}</td> - <td>Définition initiale.</td> - </tr> - </tbody> -</table> +| Spécification | Statut | Commentaire | +| ---------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------- | ---------------------------------------------------------------------- | +| {{SpecName('DOM WHATWG', '#dom-nodeiterator-root', 'NodeIterator.root')}} | {{Spec2('DOM WHATWG')}} | Pas de changement de {{SpecName('DOM2 Traversal_Range')}}. | +| {{SpecName('DOM2 Traversal_Range', 'traversal.html#Traversal-NodeIterator-root', 'NodeIterator.root')}} | {{Spec2('DOM2 Traversal_Range')}} | Définition initiale. | -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs +{{Compat("api.NodeIterator.root")}} +## Voir aussi -<p>{{Compat("api.NodeIterator.root")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>L'interface à laquelle elle appartient : {{domxref("NodeIterator")}}.</li> -</ul> +- L'interface à laquelle elle appartient : {{domxref("NodeIterator")}}. diff --git a/files/fr/web/api/nodeiterator/whattoshow/index.md b/files/fr/web/api/nodeiterator/whattoshow/index.md index 216eee5ac5..1cd3450056 100644 --- a/files/fr/web/api/nodeiterator/whattoshow/index.md +++ b/files/fr/web/api/nodeiterator/whattoshow/index.md @@ -10,136 +10,155 @@ tags: - Propriétés translation_of: Web/API/NodeIterator/whatToShow --- -<div>{{APIRef("DOM")}}</div> +{{APIRef("DOM")}} -<p>La propriété en lecture seule <strong><code>NodeIterator.whatToShow</code></strong> est un <code>unsigned integer</code> (<em>entier non signé</em>) représentant un masque de bits désignant le type de noeuds qui doit être renvoyé par le {{domxref("NodeIterator")}}.</p> +La propriété en lecture seule **`NodeIterator.whatToShow`** est un `unsigned integer` (_entier non signé_) représentant un masque de bits désignant le type de noeuds qui doit être renvoyé par le {{domxref("NodeIterator")}}. -<h2 id="Syntax">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox">var nodeTypes = <em>nodeIterator</em>.whatToShow; -</pre> + var nodeTypes = nodeIterator.whatToShow; -<p>Les valeurs pouvant être combinées pour former le masque de bits sont :</p> +Les valeurs pouvant être combinées pour former le masque de bits sont : <table class="standard-table"> - <tbody> - <tr> - <td class="header">Constante</td> - <td class="header">Valeur numérique</td> - <td class="header">Description</td> - </tr> - <tr> - <td><code>NodeFilter.SHOW_ALL</code></td> - <td><code>-1</code> (c'est la valeur numérique maximale du <code>unsigned long</code> (<em>non signé long</em>))</td> - <td>Affiche tous les noeuds.</td> - </tr> - <tr> - <td><code>NodeFilter.SHOW_ATTRIBUTE</code> {{deprecated_inline}}</td> - <td><code>2</code></td> - <td>Affiche l'attribut {{domxref("Attr")}} des noeuds. Cela n'a de sens que lors de la création d'un {{domxref("TreeWalker")}} avec un noeud {{domxref("Attr")}} comme racine ; dans ce cas, cela signifie que le nœud d'attribut apparaîtra dans la première position de l'itération ou de la traversée. Comme les attributs ne sont jamais des enfants d'autres nœuds, ils n'apparaissent pas lors de la traversée de l'arbre du document.</td> - </tr> - <tr> - <td><code>NodeFilter.SHOW_CDATA_SECTION</code> {{deprecated_inline}}</td> - <td><code>8</code></td> - <td>Affiche les noeuds {{domxref("CDATASection")}}.</td> - </tr> - <tr> - <td><code>NodeFilter.SHOW_COMMENT</code></td> - <td><code>128</code></td> - <td>Affiche les noeuds {{domxref("Comment")}}.</td> - </tr> - <tr> - <td><code>NodeFilter.SHOW_DOCUMENT</code></td> - <td><code>256</code></td> - <td>Affiche les noeuds {{domxref("Document")}}.</td> - </tr> - <tr> - <td><code>NodeFilter.SHOW_DOCUMENT_FRAGMENT</code></td> - <td><code>1024</code></td> - <td>Affiche les noeuds {{domxref("DocumentFragment")}}.</td> - </tr> - <tr> - <td><code>NodeFilter.SHOW_DOCUMENT_TYPE</code></td> - <td><code>512</code></td> - <td>Affiche les noeuds {{domxref("DocumentType")}}.</td> - </tr> - <tr> - <td><code>NodeFilter.SHOW_ELEMENT</code></td> - <td><code>1</code></td> - <td>Affiche les noeuds {{domxref("Element")}}.</td> - </tr> - <tr> - <td><code>NodeFilter.SHOW_ENTITY</code> {{deprecated_inline}}</td> - <td><code>32</code></td> - <td>Affiche les noeuds {{domxref("Entity")}}. Cela n'a de sens que lors de la création d'un {{domxref("TreeWalker")}} avec un noeud {{ domxref("Entity") }} comme racine ; dans ce cas, il signifie que le noeud d'entité {{domxref("Entity") }} apparaîtra à la première position de la traversée. Étant donné que les entités ne font pas partie de l'arborescence du document, elles n'apparaissent pas lors de la traversée de l'arborescence du document.</td> - </tr> - <tr> - <td><code>NodeFilter.SHOW_ENTITY_REFERENCE</code> {{deprecated_inline}}</td> - <td><code>16</code></td> - <td>Affiche les noeuds {{domxref("EntityReference")}}.</td> - </tr> - <tr> - <td><code>NodeFilter.SHOW_NOTATION</code> {{deprecated_inline}}</td> - <td><code>2048</code></td> - <td>Affiche les noeuds {{domxref("Notation")}}. Cela n'a de sens que lors de la création d'un {{domxref("TreeWalker")}} avec un noeud {{domxref("Notation")}} comme racine ; dans ce cas, il signifie que le noeud {{domxref("Notation")}} apparaîtra à la première position de la traversée. Étant donné que les entités ne font pas partie de l'arborescence du document, elles n'apparaissent pas lors de la traversée de l'arborescence du document.</td> - </tr> - <tr> - <td><code>NodeFilter.SHOW_PROCESSING_INSTRUCTION</code></td> - <td><code>64</code></td> - <td>Affiche les noeuds {{domxref("ProcessingInstruction")}}.</td> - </tr> - <tr> - <td><code>NodeFilter.SHOW_TEXT</code></td> - <td><code>4</code></td> - <td>Affiche les noeuds {{domxref("Text")}}.</td> - </tr> - </tbody> + <tbody> + <tr> + <td class="header">Constante</td> + <td class="header">Valeur numérique</td> + <td class="header">Description</td> + </tr> + <tr> + <td><code>NodeFilter.SHOW_ALL</code></td> + <td> + <code>-1</code> (c'est la valeur numérique maximale du + <code>unsigned long</code> (<em>non signé long</em>)) + </td> + <td>Affiche tous les noeuds.</td> + </tr> + <tr> + <td> + <code>NodeFilter.SHOW_ATTRIBUTE</code> {{deprecated_inline}} + </td> + <td><code>2</code></td> + <td> + Affiche l'attribut {{domxref("Attr")}} des noeuds. Cela n'a de sens + que lors de la création d'un {{domxref("TreeWalker")}} avec un + noeud {{domxref("Attr")}} comme racine ; dans ce cas, cela signifie + que le nœud d'attribut apparaîtra dans la première position de + l'itération ou de la traversée. Comme les attributs ne sont jamais des + enfants d'autres nœuds, ils n'apparaissent pas lors de la traversée de + l'arbre du document. + </td> + </tr> + <tr> + <td> + <code>NodeFilter.SHOW_CDATA_SECTION</code> {{deprecated_inline}} + </td> + <td><code>8</code></td> + <td>Affiche les noeuds {{domxref("CDATASection")}}.</td> + </tr> + <tr> + <td><code>NodeFilter.SHOW_COMMENT</code></td> + <td><code>128</code></td> + <td>Affiche les noeuds {{domxref("Comment")}}.</td> + </tr> + <tr> + <td><code>NodeFilter.SHOW_DOCUMENT</code></td> + <td><code>256</code></td> + <td>Affiche les noeuds {{domxref("Document")}}.</td> + </tr> + <tr> + <td><code>NodeFilter.SHOW_DOCUMENT_FRAGMENT</code></td> + <td><code>1024</code></td> + <td>Affiche les noeuds {{domxref("DocumentFragment")}}.</td> + </tr> + <tr> + <td><code>NodeFilter.SHOW_DOCUMENT_TYPE</code></td> + <td><code>512</code></td> + <td>Affiche les noeuds {{domxref("DocumentType")}}.</td> + </tr> + <tr> + <td><code>NodeFilter.SHOW_ELEMENT</code></td> + <td><code>1</code></td> + <td>Affiche les noeuds {{domxref("Element")}}.</td> + </tr> + <tr> + <td><code>NodeFilter.SHOW_ENTITY</code> {{deprecated_inline}}</td> + <td><code>32</code></td> + <td> + Affiche les noeuds {{domxref("Entity")}}. Cela n'a de sens que + lors de la création d'un {{domxref("TreeWalker")}} avec un noeud + {{ domxref("Entity") }} comme racine ; dans ce cas, il signifie + que le noeud d'entité {{domxref("Entity") }} apparaîtra à la + première position de la traversée. Étant donné que les entités ne font + pas partie de l'arborescence du document, elles n'apparaissent pas lors + de la traversée de l'arborescence du document. + </td> + </tr> + <tr> + <td> + <code>NodeFilter.SHOW_ENTITY_REFERENCE</code> + {{deprecated_inline}} + </td> + <td><code>16</code></td> + <td>Affiche les noeuds {{domxref("EntityReference")}}.</td> + </tr> + <tr> + <td> + <code>NodeFilter.SHOW_NOTATION</code> {{deprecated_inline}} + </td> + <td><code>2048</code></td> + <td> + Affiche les noeuds {{domxref("Notation")}}. Cela n'a de sens + que lors de la création d'un {{domxref("TreeWalker")}} avec un + noeud {{domxref("Notation")}} comme racine ; dans ce cas, il + signifie que le noeud {{domxref("Notation")}} apparaîtra à la + première position de la traversée. Étant donné que les entités ne font + pas partie de l'arborescence du document, elles n'apparaissent pas lors + de la traversée de l'arborescence du document. + </td> + </tr> + <tr> + <td><code>NodeFilter.SHOW_PROCESSING_INSTRUCTION</code></td> + <td><code>64</code></td> + <td> + Affiche les noeuds {{domxref("ProcessingInstruction")}}. + </td> + </tr> + <tr> + <td><code>NodeFilter.SHOW_TEXT</code></td> + <td><code>4</code></td> + <td>Affiche les noeuds {{domxref("Text")}}.</td> + </tr> + </tbody> </table> -<h2 id="Example">Exemple</h2> +## Exemple -<pre class="brush: js">var nodeIterator = document.createNodeIterator( +```js +var nodeIterator = document.createNodeIterator( document.body, NodeFilter.SHOW_ELEMENT + NodeFilter.SHOW_COMMENT + NodeFilter.SHOW_TEXT, { acceptNode: function(node) { return NodeFilter.FILTER_ACCEPT; } }, false ); if( (nodeIterator.whatToShow == NodeFilter.SHOW_ALL) || - (nodeIterator.whatToShow % (NodeFilter.SHOW_COMMENT*2)) >= NodeFilter.SHOW_COMMENT) { + (nodeIterator.whatToShow % (NodeFilter.SHOW_COMMENT*2)) >= NodeFilter.SHOW_COMMENT) { // nodeIterator affichera les commentaires } -</pre> +``` -<h2 id="Specification">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-nodeiterator-whattoshow', 'NodeIterator.whatToShow')}}</td> - <td>{{Spec2('DOM WHATWG')}}</td> - <td>Pas de changement depuis {{SpecName('DOM2 Traversal_Range')}}.</td> - </tr> - <tr> - <td>{{SpecName('DOM2 Traversal_Range', 'traversal.html#Traversal-NodeIterator-whatToShow', 'NodeIterator.whatToShow')}}</td> - <td>{{Spec2('DOM2 Traversal_Range')}}</td> - <td>Définitioni initiale.</td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> +## Spécifications +| Spécification | Statut | Commentaire | +| -------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------- | -------------------------------------------------------------------------- | +| {{SpecName('DOM WHATWG', '#dom-nodeiterator-whattoshow', 'NodeIterator.whatToShow')}} | {{Spec2('DOM WHATWG')}} | Pas de changement depuis {{SpecName('DOM2 Traversal_Range')}}. | +| {{SpecName('DOM2 Traversal_Range', 'traversal.html#Traversal-NodeIterator-whatToShow', 'NodeIterator.whatToShow')}} | {{Spec2('DOM2 Traversal_Range')}} | Définitioni initiale. | +## Compatibilité des navigateurs -<p>{{Compat("api.NodeIterator.whatToShow")}}</p> +{{Compat("api.NodeIterator.whatToShow")}} -<h2 id="Voir_aussi">Voir aussi</h2> +## Voir aussi -<ul> - <li>L'interface à laquelle cette propriété appartient : {{domxref("NodeIterator")}}.</li> -</ul> +- L'interface à laquelle cette propriété appartient : {{domxref("NodeIterator")}}. |