diff options
author | Peter Bengtsson <mail@peterbe.com> | 2020-12-08 14:40:17 -0500 |
---|---|---|
committer | Peter Bengtsson <mail@peterbe.com> | 2020-12-08 14:40:17 -0500 |
commit | 33058f2b292b3a581333bdfb21b8f671898c5060 (patch) | |
tree | 51c3e392513ec574331b2d3f85c394445ea803c6 /files/fr/web/api/nodeiterator | |
parent | 8b66d724f7caf0157093fb09cfec8fbd0c6ad50a (diff) | |
download | translated-content-33058f2b292b3a581333bdfb21b8f671898c5060.tar.gz translated-content-33058f2b292b3a581333bdfb21b8f671898c5060.tar.bz2 translated-content-33058f2b292b3a581333bdfb21b8f671898c5060.zip |
initial commit
Diffstat (limited to 'files/fr/web/api/nodeiterator')
-rw-r--r-- | files/fr/web/api/nodeiterator/detach/index.html | 69 | ||||
-rw-r--r-- | files/fr/web/api/nodeiterator/expandentityreferences/index.html | 68 | ||||
-rw-r--r-- | files/fr/web/api/nodeiterator/filter/index.html | 66 | ||||
-rw-r--r-- | files/fr/web/api/nodeiterator/index.html | 210 | ||||
-rw-r--r-- | files/fr/web/api/nodeiterator/nextnode/index.html | 67 | ||||
-rw-r--r-- | files/fr/web/api/nodeiterator/pointerbeforereferencenode/index.html | 59 | ||||
-rw-r--r-- | files/fr/web/api/nodeiterator/previousnode/index.html | 69 | ||||
-rw-r--r-- | files/fr/web/api/nodeiterator/referencenode/index.html | 60 | ||||
-rw-r--r-- | files/fr/web/api/nodeiterator/root/index.html | 65 | ||||
-rw-r--r-- | files/fr/web/api/nodeiterator/whattoshow/index.html | 145 |
10 files changed, 878 insertions, 0 deletions
diff --git a/files/fr/web/api/nodeiterator/detach/index.html b/files/fr/web/api/nodeiterator/detach/index.html new file mode 100644 index 0000000000..5330650ab5 --- /dev/null +++ b/files/fr/web/api/nodeiterator/detach/index.html @@ -0,0 +1,69 @@ +--- +title: NodeIterator.detach() +slug: Web/API/NodeIterator/detach +tags: + - API + - Arborescence + - DOM + - Itérateur + - Méthodes + - Noeuds +translation_of: Web/API/NodeIterator/detach +--- +<p>{{APIRef("DOM")}}{{obsolete_header}}</p> + +<p>La méthode <strong><code>NodeIterator.detach()</code></strong> est une non opération, conservée seulement pour la rétro-compatibilité.</p> + +<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> + +<h2 id="Syntax" name="Syntax">Syntaxe</h2> + +<pre class="syntaxbox"><em>nodeIterator</em>.detach(); +</pre> + +<h2 id="Example" name="Example">Exemple</h2> + +<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 + +nodeIterator.nextNode(); // lance une exception INVALID_STATE_ERR +</pre> + +<h2 id="Specification" name="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-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> + +<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> + + + +<p>{{Compat("api.NodeIterator.detach")}}</p> + +<h2 id="Voir_aussi">Voir aussi</h2> + +<ul> + <li>L'interface à laquelle elle appartient : {{domxref("NodeIterator")}}.</li> +</ul> diff --git a/files/fr/web/api/nodeiterator/expandentityreferences/index.html b/files/fr/web/api/nodeiterator/expandentityreferences/index.html new file mode 100644 index 0000000000..bf1f66e25a --- /dev/null +++ b/files/fr/web/api/nodeiterator/expandentityreferences/index.html @@ -0,0 +1,68 @@ +--- +title: NodeIterator.expandEntityReferences +slug: Web/API/NodeIterator/expandEntityReferences +tags: + - API + - Arborescence + - DOM + - Itérateur + - Noeuds + - Propriété +translation_of: Web/API/NodeIterator/expandEntityReferences +--- +<p>{{APIRef("DOM")}} {{deprecated_header}}</p> + +<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> + +<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> + +<h2 id="Syntax" name="Syntax">Syntaxe</h2> + +<pre class="syntaxbox"><em>expand</em> = <em>nodeIterator</em>.expandEntityReferences; +</pre> + +<h2 id="Example" name="Example">Exemple</h2> + +<pre class="brush: js">var nodeIterator = document.createNodeIterator( + document.body, + NodeFilter.SHOW_ELEMENT, + { acceptNode: function(node) { return NodeFilter.FILTER_ACCEPT; } }, + false +); +expand = nodeIterator.expandEntityReferences;</pre> + +<h2 id="Specification" name="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>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> + +<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> + +<div id="compat-desktop"> + + +<p>{{Compat("api.NodeIterator.expandEntityReferences")}}</p> + +<h2 id="Voir_aussi">Voir aussi</h2> +</div> + +<ul> + <li>L'interface à laquelle cette propriété appartient : {{domxref("NodeIterator")}}.</li> +</ul> diff --git a/files/fr/web/api/nodeiterator/filter/index.html b/files/fr/web/api/nodeiterator/filter/index.html new file mode 100644 index 0000000000..d33a997c5a --- /dev/null +++ b/files/fr/web/api/nodeiterator/filter/index.html @@ -0,0 +1,66 @@ +--- +title: NodeIterator.filter +slug: Web/API/NodeIterator/filter +tags: + - API + - Arborescence + - DOM + - Itérateur + - Noeuds + - Propriétés +translation_of: Web/API/NodeIterator/filter +--- +<div>{{APIRef("DOM")}}</div> + +<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> + +<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> + +<h2 id="Syntax" name="Syntax">Syntaxe</h2> + +<pre class="syntaxbox"><em>nodeFilter</em> = <em>nodeIterator</em>.filter; +</pre> + +<h2 id="Example" name="Example">Exemple</h2> + +<pre class="brush: js">var nodeIterator = document.createNodeIterator( + document.body, + NodeFilter.SHOW_ELEMENT, + { acceptNode: function(node) { return NodeFilter.FILTER_ACCEPT; } }, + false +); +nodeFilter = nodeIterator.filter;</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-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> + +<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> + + + +<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> diff --git a/files/fr/web/api/nodeiterator/index.html b/files/fr/web/api/nodeiterator/index.html new file mode 100644 index 0000000000..eb98f4762d --- /dev/null +++ b/files/fr/web/api/nodeiterator/index.html @@ -0,0 +1,210 @@ +--- +title: NodeIterator +slug: Web/API/NodeIterator +tags: + - API + - DOM + - Itérateur + - 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" name="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" name="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" name="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>{{CompatibilityTable}}</p> + +<div id="compat-desktop"> +<table class="compat-table"> + <tbody> + <tr> + <th>Fonctionnalité</th> + <th>Chrome</th> + <th>Edge</th> + <th>Firefox (Gecko)</th> + <th>Internet Explorer</th> + <th>Opera</th> + <th>Safari</th> + </tr> + <tr> + <td>Basic support</td> + <td>1.0</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatGeckoDesktop("1.9.1")}}</td> + <td>9.0</td> + <td>9.0</td> + <td>3.0</td> + </tr> + </tbody> +</table> +</div> + +<div id="compat-mobile"> +<table class="compat-table"> + <tbody> + <tr> + <th>Fonctionnalité</th> + <th>Android</th> + <th>Edge</th> + <th>Firefox Mobile (Gecko)</th> + <th>IE Mobile</th> + <th>Opera Mobile</th> + <th>Safari Mobile</th> + </tr> + <tr> + <td>Basic support</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatGeckoMobile("1.9.1")}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>9.0</td> + <td>3.0</td> + </tr> + </tbody> +</table> +</div> + +<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> diff --git a/files/fr/web/api/nodeiterator/nextnode/index.html b/files/fr/web/api/nodeiterator/nextnode/index.html new file mode 100644 index 0000000000..8c9b61982a --- /dev/null +++ b/files/fr/web/api/nodeiterator/nextnode/index.html @@ -0,0 +1,67 @@ +--- +title: NodeIterator.nextNode() +slug: Web/API/NodeIterator/nextNode +tags: + - API + - Arborescence + - DOM + - Itérateur + - Méthodes + - Noeuds +translation_of: Web/API/NodeIterator/nextNode +--- +<div>{{APIRef("DOM")}}</div> + +<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> + +<p>Cette méthode retourne <code>null</code> quand il n'y a plus de nœuds dans l'ensemble.</p> + +<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> + +<h2 id="Syntax" name="Syntax">Syntaxe</h2> + +<pre class="syntaxbox"><em>node</em> = <em>nodeIterator</em>.nextNode(); +</pre> + +<h2 id="Example" name="Example">Exemple</h2> + +<pre class="brush: 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" name="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-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> + +<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> + + + +<p>{{Compat("api.NodeIterator.nextNode")}}</p> + +<h2 id="Voir_aussi">Voir aussi</h2> + +<p>L'interface à laquelle elle appartient : {{domxref("NodeIterator")}}.</p> diff --git a/files/fr/web/api/nodeiterator/pointerbeforereferencenode/index.html b/files/fr/web/api/nodeiterator/pointerbeforereferencenode/index.html new file mode 100644 index 0000000000..439bfe8df6 --- /dev/null +++ b/files/fr/web/api/nodeiterator/pointerbeforereferencenode/index.html @@ -0,0 +1,59 @@ +--- +title: NodeIterator.pointerBeforeReferenceNode +slug: Web/API/NodeIterator/pointerBeforeReferenceNode +tags: + - API + - Arborescence + - DOM + - Itérateur + - Noeuds + - Propriétés +translation_of: Web/API/NodeIterator/pointerBeforeReferenceNode +--- +<p>{{APIRef("DOM")}} {{SeeCompatTable}}</p> + +<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> + +<h2 id="Syntax" name="Syntax">Syntaxe</h2> + +<pre class="syntaxbox"><em>flag</em> = <em>nodeIterator</em>.pointerBeforeReferenceNode; +</pre> + +<h2 id="Example" name="Example">Exemple</h2> + +<pre class="brush: js">var nodeIterator = document.createNodeIterator( + document.body, + NodeFilter.SHOW_ELEMENT, + { acceptNode: function(node) { return NodeFilter.FILTER_ACCEPT; } }, + false +); +flag = nodeIterator.pointerBeforeReferenceNode;</pre> + +<h2 id="Specification" name="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-pointerbeforereferencenode', 'NodeIterator.pointerBeforeReferenceNode')}}</td> + <td>{{Spec2('DOM WHATWG')}}</td> + <td>Définition initiale.</td> + </tr> + </tbody> +</table> + +<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> + + + +<p>{{Compat("api.NodeIterator.pointerBeforeReferenceNode")}}</p> + +<h2 id="Voir_aussi">Voir aussi</h2> + +<ul> + <li>L'interface à laquelle elle appartient : {{domxref("NodeIterator")}}</li> +</ul> diff --git a/files/fr/web/api/nodeiterator/previousnode/index.html b/files/fr/web/api/nodeiterator/previousnode/index.html new file mode 100644 index 0000000000..d0bfa021f4 --- /dev/null +++ b/files/fr/web/api/nodeiterator/previousnode/index.html @@ -0,0 +1,69 @@ +--- +title: NodeIterator.previousNode() +slug: Web/API/NodeIterator/previousNode +tags: + - API + - Arborescence + - DOM + - Méthodes + - Noeuds +translation_of: Web/API/NodeIterator/previousNode +--- +<div>{{APIRef("DOM")}}</div> + +<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> + +<p>Cette méthode renvoie <code>null</code> si le noeud courant est le premier noeud dans l'ensemble.</p> + +<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> + +<h2 id="Syntax" name="Syntax">Syntaxe</h2> + +<pre class="syntaxbox"><em>node</em> = <em>nodeIterator</em>.previousNode(); +</pre> + +<h2 id="Example" name="Example">Exemple</h2> + +<pre class="brush: js">var nodeIterator = document.createNodeIterator( + document.body, + NodeFilter.SHOW_ELEMENT, + { acceptNode: function(node) { return NodeFilter.FILTER_ACCEPT; } }, + false // cet argument facultatif n'est plus utilisé +); +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" name="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-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> + +<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> + + + +<p>{{Compat("api.NodeIterator.previousNode")}}</p> + +<h2 id="Voir_aussi">Voir aussi</h2> + +<ul> + <li>L'interface à laquelle elle appartient : {{domxref("NodeIterator")}}.</li> +</ul> diff --git a/files/fr/web/api/nodeiterator/referencenode/index.html b/files/fr/web/api/nodeiterator/referencenode/index.html new file mode 100644 index 0000000000..b138a52723 --- /dev/null +++ b/files/fr/web/api/nodeiterator/referencenode/index.html @@ -0,0 +1,60 @@ +--- +title: NodeIterator.referenceNode +slug: Web/API/NodeIterator/referenceNode +tags: + - API + - Arborescence + - DOM + - Itérateur + - Noeuds + - Propriétés +translation_of: Web/API/NodeIterator/referenceNode +--- +<p>{{APIRef("DOM")}}{{ SeeCompatTable }}</p> + +<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> + +<h2 id="Syntax" name="Syntax">Syntaxe</h2> + +<pre class="syntaxbox"><em>node</em> = <em>nodeIterator</em>.referenceNode; +</pre> + +<h2 id="Example" name="Example">Exemple</h2> + +<pre class="brush: 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" name="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-referencenode', 'NodeIterator.referenceNode')}}</td> + <td>{{Spec2('DOM WHATWG')}}</td> + <td>Définition initiale.</td> + </tr> + </tbody> +</table> + +<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> + + + +<p>{{Compat("api.NodeIterator.referenceNode")}}</p> + +<h2 id="Voir_aussi">Voir aussi</h2> + +<ul> + <li>L'interface à laquelle elle appartient : {{domxref("NodeIterator")}}</li> +</ul> diff --git a/files/fr/web/api/nodeiterator/root/index.html b/files/fr/web/api/nodeiterator/root/index.html new file mode 100644 index 0000000000..b5d6aeead3 --- /dev/null +++ b/files/fr/web/api/nodeiterator/root/index.html @@ -0,0 +1,65 @@ +--- +title: NodeIterator.root +slug: Web/API/NodeIterator/root +tags: + - API + - Arborescence + - DOM + - Itérateur + - Noeuds + - Propriété +translation_of: Web/API/NodeIterator/root +--- +<div>{{APIRef("DOM")}}</div> + +<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> + +<h2 id="Syntax" name="Syntax">Syntaxe</h2> + +<pre class="syntaxbox"><em>root</em> = <em>nodeIterator</em>.root; +</pre> + +<h2 id="Example" name="Example">Exemple</h2> + +<pre class="brush: 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" name="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-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> + +<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> + + + +<p>{{Compat("api.NodeIterator.root")}}</p> + +<h2 id="Voir_aussi">Voir aussi</h2> + +<ul> + <li>L'interface à laquelle elle appartient : {{domxref("NodeIterator")}}.</li> +</ul> diff --git a/files/fr/web/api/nodeiterator/whattoshow/index.html b/files/fr/web/api/nodeiterator/whattoshow/index.html new file mode 100644 index 0000000000..a36dbc4527 --- /dev/null +++ b/files/fr/web/api/nodeiterator/whattoshow/index.html @@ -0,0 +1,145 @@ +--- +title: NodeIterator.whatToShow +slug: Web/API/NodeIterator/whatToShow +tags: + - API + - Arborescence + - DOM + - Itérateur + - Noeuds + - Propriétés +translation_of: Web/API/NodeIterator/whatToShow +--- +<div>{{APIRef("DOM")}}</div> + +<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> + +<h2 id="Syntax" name="Syntax">Syntaxe</h2> + +<pre class="syntaxbox">var nodeTypes = <em>nodeIterator</em>.whatToShow; +</pre> + +<p>Les valeurs pouvant être combinées pour former le masque de bits sont :</p> + +<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> +</table> + +<h2 id="Example" name="Example">Exemple</h2> + +<pre class="brush: 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 affichera les commentaires +} +</pre> + +<h2 id="Specification" name="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> + + + +<p>{{Compat("api.NodeIterator.whatToShow")}}</p> + +<h2 id="Voir_aussi">Voir aussi</h2> + +<ul> + <li>L'interface à laquelle cette propriété appartient : {{domxref("NodeIterator")}}.</li> +</ul> |