From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- files/fr/web/api/nodeiterator/detach/index.html | 69 +++++++ .../nodeiterator/expandentityreferences/index.html | 68 +++++++ files/fr/web/api/nodeiterator/filter/index.html | 66 +++++++ files/fr/web/api/nodeiterator/index.html | 210 +++++++++++++++++++++ files/fr/web/api/nodeiterator/nextnode/index.html | 67 +++++++ .../pointerbeforereferencenode/index.html | 59 ++++++ .../web/api/nodeiterator/previousnode/index.html | 69 +++++++ .../web/api/nodeiterator/referencenode/index.html | 60 ++++++ files/fr/web/api/nodeiterator/root/index.html | 65 +++++++ .../fr/web/api/nodeiterator/whattoshow/index.html | 145 ++++++++++++++ 10 files changed, 878 insertions(+) create mode 100644 files/fr/web/api/nodeiterator/detach/index.html create mode 100644 files/fr/web/api/nodeiterator/expandentityreferences/index.html create mode 100644 files/fr/web/api/nodeiterator/filter/index.html create mode 100644 files/fr/web/api/nodeiterator/index.html create mode 100644 files/fr/web/api/nodeiterator/nextnode/index.html create mode 100644 files/fr/web/api/nodeiterator/pointerbeforereferencenode/index.html create mode 100644 files/fr/web/api/nodeiterator/previousnode/index.html create mode 100644 files/fr/web/api/nodeiterator/referencenode/index.html create mode 100644 files/fr/web/api/nodeiterator/root/index.html create mode 100644 files/fr/web/api/nodeiterator/whattoshow/index.html (limited to 'files/fr/web/api/nodeiterator') 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 +--- +

{{APIRef("DOM")}}{{obsolete_header}}

+ +

La méthode NodeIterator.detach() est une non opération, conservée seulement pour la rétro-compatibilité.

+ +

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. 

+ +

Syntaxe

+ +
nodeIterator.detach();
+
+ +

Exemple

+ +
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
+
+ +

Spécifications

+ + + + + + + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{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.
+ +

Compatibilité des navigateurs

+ + + +

{{Compat("api.NodeIterator.detach")}}

+ +

Voir aussi

+ + 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 +--- +

{{APIRef("DOM")}} {{deprecated_header}}

+ +

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")}}.

+ +

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é.

+ +

Syntaxe

+ +
expand = nodeIterator.expandEntityReferences;
+
+ +

Exemple

+ +
var nodeIterator = document.createNodeIterator(
+    document.body,
+    NodeFilter.SHOW_ELEMENT,
+    { acceptNode: function(node) { return NodeFilter.FILTER_ACCEPT; } },
+    false
+);
+expand = nodeIterator.expandEntityReferences;
+ +

Spécifications

+ + + + + + + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{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.
+ +

Compatibilité des navigateurs

+ +
+ + +

{{Compat("api.NodeIterator.expandEntityReferences")}}

+ +

Voir aussi

+
+ + 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 +--- +
{{APIRef("DOM")}}
+ +

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.

+ +

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é.

+ +

Syntaxe

+ +
nodeFilter = nodeIterator.filter;
+
+ +

Exemple

+ +
var nodeIterator = document.createNodeIterator(
+    document.body,
+    NodeFilter.SHOW_ELEMENT,
+    { acceptNode: function(node) { return NodeFilter.FILTER_ACCEPT; } },
+    false
+);
+nodeFilter = nodeIterator.filter;
+ +

Spécifications

+ + + + + + + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{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.
+ +

Compatibilité des navigateurs

+ + + +

{{Compat("api.NodeIterator.filter")}}

+ +

Voir aussi

+ + 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 +--- +
{{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 :

+ +
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 : + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
ConstanteValeur numériqueDescription
NodeFilter.SHOW_ALL-1 (c'est la valeur numérique maximale du unsigned long (non signé long))Affiche tous les noeuds.
NodeFilter.SHOW_ATTRIBUTE {{obsolete_inline}}2Affiche 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.
NodeFilter.SHOW_CDATA_SECTION {{obsolete_inline}}8Affiche les noeuds {{domxref("CDATASection")}}.
NodeFilter.SHOW_COMMENT128Affiche les noeuds {{domxref("Comment")}}.
NodeFilter.SHOW_DOCUMENT256Affiche les noeuds {{domxref("Document")}}.
NodeFilter.SHOW_DOCUMENT_FRAGMENT1024Affiche les noeuds {{domxref("DocumentFragment")}}.
NodeFilter.SHOW_DOCUMENT_TYPE512Affiche les noeuds {{domxref("DocumentType")}}.
NodeFilter.SHOW_ELEMENT1Affiche les noeuds {{domxref("Element")}}.
NodeFilter.SHOW_ENTITY {{obsolete_inline}}32Affiche 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.
NodeFilter.SHOW_ENTITY_REFERENCE {{obsolete_inline}}16Affiche les noeuds {{domxref("EntityReference")}}.
NodeFilter.SHOW_NOTATION {{obsolete_inline}}2048Affiche 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.
NodeFilter.SHOW_PROCESSING_INSTRUCTION64Affiche les noeuds {{domxref("ProcessingInstruction")}}.
NodeFilter.SHOW_TEXT4Affiche les noeuds {{domxref("Text")}}.
+
+
{{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écificationStatutCommentaire
{{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

+ +

{{CompatibilityTable}}

+ +
+ + + + + + + + + + + + + + + + + + + + + +
FonctionnalitéChromeEdgeFirefox (Gecko)Internet ExplorerOperaSafari
Basic support1.0{{CompatVersionUnknown}}{{CompatGeckoDesktop("1.9.1")}}9.09.03.0
+
+ +
+ + + + + + + + + + + + + + + + + + + + + +
FonctionnalitéAndroidEdgeFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Basic support{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatGeckoMobile("1.9.1")}}{{CompatVersionUnknown}}9.03.0
+
+ +

Voir aussi

+ + 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 +--- +
{{APIRef("DOM")}}
+ +

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.

+ +

Cette méthode retourne null quand il n'y a plus de nœuds dans l'ensemble.

+ +

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.

+ +

Syntaxe

+ +
node = nodeIterator.nextNode();
+
+ +

Exemple

+ +
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.
+
+ +

Spécifications

+ + + + + + + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{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.
+ +

Compatibilité des navigateurs

+ + + +

{{Compat("api.NodeIterator.nextNode")}}

+ +

Voir aussi

+ +

L'interface à laquelle elle appartient : {{domxref("NodeIterator")}}.

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 +--- +

{{APIRef("DOM")}} {{SeeCompatTable}}

+ +

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")}}.

+ +

Syntaxe

+ +
flag = nodeIterator.pointerBeforeReferenceNode;
+
+ +

Exemple

+ +
var nodeIterator = document.createNodeIterator(
+    document.body,
+    NodeFilter.SHOW_ELEMENT,
+    { acceptNode: function(node) { return NodeFilter.FILTER_ACCEPT; } },
+    false
+);
+flag = nodeIterator.pointerBeforeReferenceNode;
+ +

Spécifications

+ + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{SpecName('DOM WHATWG', '#dom-nodeiterator-pointerbeforereferencenode', 'NodeIterator.pointerBeforeReferenceNode')}}{{Spec2('DOM WHATWG')}}Définition initiale.
+ +

Compatibilité des navigateurs

+ + + +

{{Compat("api.NodeIterator.pointerBeforeReferenceNode")}}

+ +

Voir aussi

+ + 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 +--- +
{{APIRef("DOM")}}
+ +

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.

+ +

Cette méthode renvoie null si le noeud courant est le premier noeud dans l'ensemble.

+ +

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.

+ +

Syntaxe

+ +
node = nodeIterator.previousNode();
+
+ +

Exemple

+ +
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
+
+ +

Spécifications

+ + + + + + + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{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.
+ +

Compatibilité des navigateurs

+ + + +

{{Compat("api.NodeIterator.previousNode")}}

+ +

Voir aussi

+ + 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 +--- +

{{APIRef("DOM")}}{{ SeeCompatTable }}

+ +

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é.

+ +

Syntaxe

+ +
node = nodeIterator.referenceNode;
+
+ +

Exemple

+ +
var nodeIterator = document.createNodeIterator(
+    document.body,
+    NodeFilter.SHOW_ELEMENT,
+    { acceptNode: function(node) { return NodeFilter.FILTER_ACCEPT; } },
+    false
+);
+node = nodeIterator.referenceNode;
+
+ +

Spécifications

+ + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{SpecName('DOM WHATWG', '#dom-nodeiterator-referencenode', 'NodeIterator.referenceNode')}}{{Spec2('DOM WHATWG')}}Définition initiale.
+ +

Compatibilité des navigateurs

+ + + +

{{Compat("api.NodeIterator.referenceNode")}}

+ +

Voir aussi

+ + 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 +--- +
{{APIRef("DOM")}}
+ +

La propriété en lecture seule NodeIterator.root représente le {{DOMxref("Node")}} qui est la racine de ce que le {{DOMxref("NodeIterator")}} traverse.

+ +

Syntaxe

+ +
root = nodeIterator.root;
+
+ +

Exemple

+ +
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
+
+ +

Spécifications

+ + + + + + + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{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.
+ +

Compatibilité des navigateurs

+ + + +

{{Compat("api.NodeIterator.root")}}

+ +

Voir aussi

+ + 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 +--- +
{{APIRef("DOM")}}
+ +

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")}}.

+ +

Syntaxe

+ +
var nodeTypes = nodeIterator.whatToShow;
+
+ +

Les valeurs pouvant être combinées pour former le masque de bits sont :

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
ConstanteValeur numériqueDescription
NodeFilter.SHOW_ALL-1 (c'est la valeur numérique maximale du unsigned long (non signé long))Affiche tous les noeuds.
NodeFilter.SHOW_ATTRIBUTE {{deprecated_inline}}2Affiche 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.
NodeFilter.SHOW_CDATA_SECTION {{deprecated_inline}}8Affiche les noeuds {{domxref("CDATASection")}}.
NodeFilter.SHOW_COMMENT128Affiche les noeuds {{domxref("Comment")}}.
NodeFilter.SHOW_DOCUMENT256Affiche les noeuds {{domxref("Document")}}.
NodeFilter.SHOW_DOCUMENT_FRAGMENT1024Affiche les noeuds {{domxref("DocumentFragment")}}.
NodeFilter.SHOW_DOCUMENT_TYPE512Affiche les noeuds {{domxref("DocumentType")}}.
NodeFilter.SHOW_ELEMENT1Affiche les noeuds {{domxref("Element")}}.
NodeFilter.SHOW_ENTITY {{deprecated_inline}}32Affiche 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.
NodeFilter.SHOW_ENTITY_REFERENCE {{deprecated_inline}}16Affiche les noeuds {{domxref("EntityReference")}}.
NodeFilter.SHOW_NOTATION {{deprecated_inline}}2048Affiche 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.
NodeFilter.SHOW_PROCESSING_INSTRUCTION64Affiche les noeuds {{domxref("ProcessingInstruction")}}.
NodeFilter.SHOW_TEXT4Affiche les noeuds {{domxref("Text")}}.
+ +

Exemple

+ +
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
+}
+
+ +

Spécifications

+ + + + + + + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{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

+ + + +

{{Compat("api.NodeIterator.whatToShow")}}

+ +

Voir aussi

+ + -- cgit v1.2.3-54-g00ecf