From 1407c8fdef01ecd0ffb8a8bd46e7113f119b9fde Mon Sep 17 00:00:00 2001 From: julieng Date: Sat, 2 Oct 2021 17:20:24 +0200 Subject: convert content to md --- files/fr/web/api/node/appendchild/index.md | 116 +++--- files/fr/web/api/node/baseuri/index.md | 63 ++- files/fr/web/api/node/childnodes/index.md | 127 +++--- files/fr/web/api/node/clonenode/index.md | 95 ++--- .../web/api/node/comparedocumentposition/index.md | 139 +++---- files/fr/web/api/node/contains/index.md | 64 ++- files/fr/web/api/node/firstchild/index.md | 99 ++--- files/fr/web/api/node/getrootnode/index.md | 88 ++-- files/fr/web/api/node/haschildnodes/index.md | 90 ++--- files/fr/web/api/node/index.md | 448 +++++++++------------ files/fr/web/api/node/insertbefore/index.md | 160 +++----- files/fr/web/api/node/isconnected/index.md | 66 ++- files/fr/web/api/node/isdefaultnamespace/index.md | 33 +- files/fr/web/api/node/isequalnode/index.md | 86 ++-- files/fr/web/api/node/issamenode/index.md | 107 +++-- files/fr/web/api/node/issupported/index.md | 91 ++--- files/fr/web/api/node/lastchild/index.md | 64 +-- files/fr/web/api/node/lookupnamespaceuri/index.md | 14 +- files/fr/web/api/node/lookupprefix/index.md | 12 +- files/fr/web/api/node/nextsibling/index.md | 63 ++- files/fr/web/api/node/nodename/index.md | 151 +++---- files/fr/web/api/node/nodetype/index.md | 235 +++++------ files/fr/web/api/node/nodevalue/index.md | 131 +++--- files/fr/web/api/node/normalize/index.md | 27 +- files/fr/web/api/node/ownerdocument/index.md | 59 +-- files/fr/web/api/node/parentelement/index.md | 45 +-- files/fr/web/api/node/parentnode/index.md | 57 ++- files/fr/web/api/node/previoussibling/index.md | 55 ++- files/fr/web/api/node/removechild/index.md | 110 ++--- files/fr/web/api/node/replacechild/index.md | 82 ++-- files/fr/web/api/node/textcontent/index.md | 134 +++--- 31 files changed, 1247 insertions(+), 1864 deletions(-) (limited to 'files/fr/web/api/node') diff --git a/files/fr/web/api/node/appendchild/index.md b/files/fr/web/api/node/appendchild/index.md index 800be4c3bb..c71ba507b3 100644 --- a/files/fr/web/api/node/appendchild/index.md +++ b/files/fr/web/api/node/appendchild/index.md @@ -10,90 +10,64 @@ tags: - Noeuds translation_of: Web/API/Node/appendChild --- -

{{APIRef("DOM")}}

+{{APIRef("DOM")}} -

La méthode Node.appendChild() ajoute un nœud à la fin de la liste des enfants d'un nœud parent spécifié. Si l'enfant donné est une référence à un nœud existant dans le document, appendChild() le déplace  de sa position actuelle vers une nouvelle position (il n'est pas nécessaire de supprimer le noeud sur son noeud parent avant de l'ajouter à un autre).

+La méthode **`Node.appendChild()`** ajoute un nœud à la fin de la liste des enfants d'un nœud parent spécifié. Si l'enfant donné est une référence à un nœud existant dans le document, `appendChild()` le déplace  de sa position actuelle vers une nouvelle position (il n'est pas nécessaire de supprimer le noeud sur son noeud parent avant de l'ajouter à un autre). -

Cela signifie qu'un noeud ne peut pas être à deux points du document simultanément. Donc, si le nœud a déjà un parent, le nœud est d'abord retiré, puis ajouté à la nouvelle position. Le {{domxref("Node.cloneNode()")}} peut être utilisé pour réaliser une copie de noeud avant de l'ajouter à son nouveau parent. Notez que les copies faites avec cloneNode ne seront pas automatiquement synchronisées.

+Cela signifie qu'un noeud ne peut pas être à deux points du document simultanément. Donc, si le nœud a déjà un parent, le nœud est d'abord retiré, puis ajouté à la nouvelle position. Le {{domxref("Node.cloneNode()")}} peut être utilisé pour réaliser une copie de noeud avant de l'ajouter à son nouveau parent. Notez que les copies faites avec `cloneNode` ne seront pas automatiquement synchronisées. -

Si l'enfant donné est un {{domxref("DocumentFragment")}} , le contenu entier du {{domxref("DocumentFragment")}} est déplacé dans la liste d'enfants du noeud parent spécifié.

+Si l'enfant donné est un {{domxref("DocumentFragment")}} , le contenu entier du {{domxref("DocumentFragment")}} est déplacé dans la liste d'enfants du noeud parent spécifié. -

Syntaxe

+## Syntaxe -
var elementAjoute = element.appendChild(enfant);
-
+ var elementAjoute = element.appendChild(enfant); -

Paramètres

+### Paramètres -
-
enfant
-
Le noeud à ajouter au noeud parent donné (généralement un élément).
-
+- **enfant** + - : Le noeud à ajouter au noeud parent donné (généralement un élément). -

Valeur renvoyée

+### Valeur renvoyée -

La valeur renvoyée est l'enfant ajouté sauf si l'enfant donné est un {{domxref ("DocumentFragment")}}, auquel cas le {{domxref ("DocumentFragment")}} vide est renvoyé.

+La valeur renvoyée est l'enfant ajouté sauf si l'enfant donné est un {{domxref ("DocumentFragment")}}, auquel cas le {{domxref ("DocumentFragment")}} vide est renvoyé. -

Notes

+## Notes -

Le chaînage peut ne pas fonctionner comme prévu en raison de appendChild() renvoyant l'élément enfant :

+Le chaînage peut ne pas fonctionner comme prévu en raison de `appendChild()` renvoyant l'élément enfant : -
var aBlock = doc.createElement('block').appendChild(doc.createElement('b'));
+```js +var aBlock = doc.createElement('block').appendChild(doc.createElement('b')); +``` -

Définit aBlock pour <b></b> uniquement, ce que vous ne voulez probablement pas.

+Définit `aBlock` pour `` uniquement, ce que vous ne voulez probablement pas. -

Exemple

+## Exemple -
// Crée un nouvel élément paragraphe et l'ajoute à la fin du corps du document
+```js
+// Crée un nouvel élément paragraphe et l'ajoute à la fin du corps du document
 var p = document.createElement("p");
-document.body.appendChild(p);
- -

Spécification

- -

 

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('DOM WHATWG', '#dom-node-appendchild', 'Node.appendChild()')}}{{Spec2('DOM WHATWG')}}Pas de changement de {{SpecName("DOM3 Core")}}.
{{SpecName('DOM3 Core', 'core.html#ID-184E7107', 'Node.appendChild()')}}{{Spec2('DOM3 Core')}}Pas de changement de {{SpecName("DOM2 Core")}}.
{{SpecName('DOM2 Core', 'core.html#ID-184E7107', 'Node.appendChild()')}}{{Spec2('DOM2 Core')}}Pas de changement de {{SpecName("DOM1")}}.
{{SpecName('DOM1', 'level-one-core.html#ID-184E7107', 'Node.appendChild()')}}{{Spec2('DOM1')}}Définition initiale.
- -

Compatibilité des navigateurs

- -

{{Compat("api.Node.appendChild")}}

- -

Voir aussi

- - +document.body.appendChild(p); +``` + +## Spécification + + + +| Spécification | Statut | Commentaire | +| -------------------------------------------------------------------------------------------------------- | -------------------------------- | ------------------------------------------------------ | +| {{SpecName('DOM WHATWG', '#dom-node-appendchild', 'Node.appendChild()')}} | {{Spec2('DOM WHATWG')}} | Pas de changement de {{SpecName("DOM3 Core")}}. | +| {{SpecName('DOM3 Core', 'core.html#ID-184E7107', 'Node.appendChild()')}} | {{Spec2('DOM3 Core')}} | Pas de changement de {{SpecName("DOM2 Core")}}. | +| {{SpecName('DOM2 Core', 'core.html#ID-184E7107', 'Node.appendChild()')}} | {{Spec2('DOM2 Core')}} | Pas de changement de {{SpecName("DOM1")}}. | +| {{SpecName('DOM1', 'level-one-core.html#ID-184E7107', 'Node.appendChild()')}} | {{Spec2('DOM1')}} | Définition initiale. | + +## Compatibilité des navigateurs + +{{Compat("api.Node.appendChild")}} + +## Voir aussi + +- {{domxref("Node.removeChild")}} +- {{domxref("Node.replaceChild")}} +- {{domxref("Node.insertBefore")}} +- {{domxref("Node.hasChildNodes")}} +- {{domxref("ParentNode.append()")}} diff --git a/files/fr/web/api/node/baseuri/index.md b/files/fr/web/api/node/baseuri/index.md index 68cf5be1bc..cbecf41d24 100644 --- a/files/fr/web/api/node/baseuri/index.md +++ b/files/fr/web/api/node/baseuri/index.md @@ -12,60 +12,49 @@ tags: - XML translation_of: Web/API/Node/baseURI --- -
-
{{APIRef("DOM")}}
-
+{{APIRef("DOM")}} -

La propriété en lecture seule Node.baseURI renvoie l'URL de base absolue d'un noeud.

+La propriété en lecture seule **`Node.baseURI`** renvoie l'URL de base absolue d'un noeud. -

L'URL de base est utilisée pour résoudre les URL relatives quand le navigateur a besoin d'obtenir une URL absolue, par exemple lors du traitement de l'attribut src  en HTML ou XML xlink:href d'un élément {{HTMLElement("img")}} HTML.

+L'URL de base est utilisée pour [résoudre](http://developers.whatwg.org/urls.html#resolving-urls) les URL relatives quand le navigateur a besoin d'obtenir une URL absolue, par exemple lors du traitement de l'attribut `src`  en HTML ou XML `xlink:href` d'un élément {{HTMLElement("img")}} HTML. -

En général, l'URL de base est simplement l'emplacement du document, mais elle peut être affectée par de nombreux facteurs, y compris l'élément {{HTMLElement("base")}} en HTML et l'attribut  xml:base en XML.

+En général, l'URL de base est simplement l'emplacement du document, mais elle peut être affectée par de nombreux facteurs, y compris l'élément {{HTMLElement("base")}} en HTML et l'attribut  [`xml:base`](/fr/docs/Introduction_%C3%A0_XML/xml:base) en XML. -

Syntaxe

+## Syntaxe -
var baseURI = node.baseURI;
-
+ var baseURI = node.baseURI; - +- `baseURI` est une {{ domxref("DOMString") }} (_chaîne de caractères_) représentant l'URL de base du {{domxref("Node")}} spécifié. Elle peut être `null` s'il est impossible d'obtenir une URI absolue. +- `node.baseURI` est en lecture seule. +- `node.baseURI` peut changer avec le temps (voir ci-dessous). -

Détails

+## Détails -

L'URL de base d'un document

+### L'URL de base d'un document -

L'URL de base d'un document est par défaut l'adresse du document (telle qu'affichée par le navigateur et disponible dans {{domxref("window.location")}}), mais peut changer par défaut :

+L'URL de base d'un _document_ est par défaut l'adresse du document (telle qu'affichée par le navigateur et disponible dans {{domxref("window.location")}}), mais peut changer par défaut : - +- Si une balise HTML {{HTMLElement("base")}} est trouvée dans le document ; +- Lorsque celui-ci est un nouveau document créé dynamiquement. -

Voir la page Base URLs section of the HTML Living standard (en) pour plus de détails.

+Voir la page [Base URLs section of the HTML Living standard](http://developers.whatwg.org/urls.html#base-urls) (en) pour plus de détails. -

Vous pouvez utiliser {{domxref("document")}}.baseURI pour obtenir l'URL de base d'un document. Notez que l'obtention de l'URL de base d'un document peut renvoyer des URL différentes au fil du temps si la balise {{HTMLElement("base")}} ou l'emplacement du document change.

+Vous pouvez utiliser `{{domxref("document")}}.baseURI` pour obtenir l'URL de base d'un document. Notez que l'obtention de l'URL de base d'un document peut renvoyer des URL différentes au fil du temps si la balise {{HTMLElement("base")}} ou l'emplacement du document change. -

L'URL de base d'un élément

+### L'URL de base d'un élément -

L'URL de base d'un element en HTML est normalement équivalente à celle du document dans lequel se trouve le noeud.

+L'URL de base d'un _element_ en HTML est normalement équivalente à celle du document dans lequel se trouve le noeud. -

Si le document contient des attributs xml:base (ce que vous ne devriez pas faire dans les documents HTML), l'element.baseURI prend en compte l'attribut xml:base des parents de l'élément  lors du calcul de l'URL de base. Voir xml:base pour plus de détails.

+Si le document contient des attributs [`xml:base`](/fr/docs/Introduction_%C3%A0_XML/xml:base) (ce que vous ne devriez pas faire dans les documents HTML), l'`element.baseURI` prend en compte l'attribut `xml:base` des parents de l'élément  lors du calcul de l'URL de base. Voir [xml:base](/fr/docs/Introduction_%C3%A0_XML/xml:base) pour plus de détails. -

Vous pouvez utiliser {{domxref("element")}}.baseURI pour obtenir l'URL de base d'un élément.

+Vous pouvez utiliser `{{domxref("element")}}.baseURI` pour obtenir l'URL de base d'un élément. -

Spécification

+## Spécification - +- {{spec("http://www.w3.org/TR/DOM-Level-3-Core/core.html#Node3-baseURI","DOM Level 3 Core: baseURI","REC")}} -

Voir aussi

+## Voir aussi - +- l'élément {{HTMLElement("base")}} (HTML) +- l'attribut [`xml:base`](/fr/docs/Introduction_%C3%A0_XML/xml:base) (documents XML). +- {{domxref("Node.baseURIObject")}} - une variante de cette API pour les add-ons Mozilla et le code interne. Renvoie l'URL de base en tant que {{interface("nsIURI")}}. diff --git a/files/fr/web/api/node/childnodes/index.md b/files/fr/web/api/node/childnodes/index.md index b9f4630ffc..4482d18e89 100644 --- a/files/fr/web/api/node/childnodes/index.md +++ b/files/fr/web/api/node/childnodes/index.md @@ -9,95 +9,68 @@ tags: - Propriétés translation_of: Web/API/Node/childNodes --- -

{{APIRef("DOM")}}

+{{APIRef("DOM")}} -

La propriété en lecture seule  Node.childNodes renvoie une {{domxref("NodeList")}} (liste de noeuds) de {{domxref("Node","noeuds")}} enfants de l'élément donné avec le premier noeud enfant affecté à l'index 0.

+La propriété en lecture seule  **`Node.childNodes`** renvoie une {{domxref("NodeList")}} (_liste de noeuds_) de {{domxref("Node","noeuds")}} enfants de l'élément donné avec le premier noeud enfant affecté à l'index 0. -

Syntaxe

+## Syntaxe -
var collNoeuds = elementDeReference.childNodes;
-
+ var collNoeuds = elementDeReference.childNodes; -

Exemples

+## Exemples -

Utilisation simple

+### Utilisation simple -
// parg est une référence d'objet pour un élément <p>
+```js
+// parg est une référence d'objet pour un élément 

-// D'abord vérifier que l'élément a des noeuds enfants +// D'abord vérifier que l'élément a des noeuds enfants if (parg.hasChildNodes()) { var children = parg.childNodes; - for (var i = 0; i < children.length; i++) { + for (var i = 0; i < children.length; i++) { // faire quelque chose avec chaque enfant[i] // NOTE: La liste est en ligne, l'ajout ou la suppression des enfants changera la liste } -}

+} +``` -

Supprimer tous les enfants d'un nom

+### Supprimer tous les enfants d'un nom -
// Voici une manière de supprimer tous les enfants d'un nœud
-// (boite est une référence à un élément ayant des enfants)
-while( boite.firstChild) {
-    // La liste n'est pas une copie, elle sera donc réindexée à chaque appel
-    boite.removeChild( boite.firstChild);
-}
-
- -

Notes

- -

Les éléments de la collection de noeuds sont des objets et non des chaînes de caractères. Pour en obtenir les données, vous devez utiliser leurs propriétés (par exemple elementNodeReference.childNodes[1].nodeName pour obtenir son nom, etc.)

- -

L'objet document lui-même a deux enfants : la déclaration Doctype et l'élément racine, généralement appelés  documentElement . (Dans les documents (X)HTML il s'agit d'éléments  HTML).

- -

childNodes  inclut tous les noeuds enfants, y compris les noeuds qui ne sont pas des éléments comme les noeuds texte et commentaire. Pour obtenir une collection des seuls éléments, utilisez {{domxref("ParentNode.children")}} à la place.

- -

 

- -

Spécification

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('DOM WHATWG', '#dom-node-childnodes', 'Node.childNodes')}}{{Spec2('DOM WHATWG')}}Pas de changement
{{SpecName('DOM3 Core', 'core.html#ID-1451460987', 'Node.childNodes')}}{{Spec2('DOM3 Core')}}Pas de changement
{{SpecName('DOM2 Core', 'core.html#ID-1451460987', 'Node.childNodes')}}{{Spec2('DOM2 Core')}}Pas de changement
{{SpecName('DOM1', 'level-one-core.html#ID-1451460987', 'Node.childNodes')}}{{Spec2('DOM1')}}Définition initiale
- -

Compatibilité des navigateurs

- -

{{Compat("api.Node.childNodes")}}

- -

Voir aussi

- - + // Voici une manière de supprimer tous les enfants d'un nœud + // (boite est une référence à un élément ayant des enfants) + while( boite.firstChild) { + // La liste n'est pas une copie, elle sera donc réindexée à chaque appel + boite.removeChild( boite.firstChild); + } + +## Notes + +Les éléments de la collection de noeuds sont des objets et non des chaînes de caractères. Pour en obtenir les données, vous devez utiliser leurs propriétés (par exemple `elementNodeReference.childNodes[1].nodeName` pour obtenir son nom, etc.) + +L'objet [`document`](/fr/DOM/document) lui-même a deux enfants : la déclaration [Doctype](/fr/DOM/document.doctype) et l'élément racine, généralement appelés  `documentElement` . (Dans les documents (X)HTML il s'agit d'éléments  [`HTML`](/fr/HTML/Element/html)). + +`childNodes`  inclut tous les noeuds enfants, y compris les noeuds qui ne sont pas des éléments comme les noeuds texte et commentaire. Pour obtenir une collection des seuls éléments, utilisez {{domxref("ParentNode.children")}} à la place. + + + +## Spécification + +| Spécification | Statut | Commentaire | +| ---------------------------------------------------------------------------------------------------- | -------------------------------- | ------------------- | +| {{SpecName('DOM WHATWG', '#dom-node-childnodes', 'Node.childNodes')}} | {{Spec2('DOM WHATWG')}} | Pas de changement | +| {{SpecName('DOM3 Core', 'core.html#ID-1451460987', 'Node.childNodes')}} | {{Spec2('DOM3 Core')}} | Pas de changement | +| {{SpecName('DOM2 Core', 'core.html#ID-1451460987', 'Node.childNodes')}} | {{Spec2('DOM2 Core')}} | Pas de changement | +| {{SpecName('DOM1', 'level-one-core.html#ID-1451460987', 'Node.childNodes')}} | {{Spec2('DOM1')}} | Définition initiale | + +## Compatibilité des navigateurs + +{{Compat("api.Node.childNodes")}} + +## Voir aussi + +- {{domxref("Node.firstChild")}} +- {{domxref("Node.lastChild")}} +- {{domxref("Node.nextSibling")}} +- {{domxref("Node.previousSibling")}} +- {{domxref("ParentNode.children")}} diff --git a/files/fr/web/api/node/clonenode/index.md b/files/fr/web/api/node/clonenode/index.md index fef79935dc..ca70a18cb3 100644 --- a/files/fr/web/api/node/clonenode/index.md +++ b/files/fr/web/api/node/clonenode/index.md @@ -9,84 +9,55 @@ tags: - Noeuds translation_of: Web/API/Node/cloneNode --- -

{{APIRef("DOM")}}

+{{APIRef("DOM")}} -

La méthode Node.cloneNode() renvoie une copie du nœud sur lequel elle a été appelée.

+La méthode **`Node.cloneNode()`** renvoie une copie du nœud sur lequel elle a été appelée. -

Syntaxe

+## Syntaxe -
var dupNode = node.cloneNode([deep]);
-
+ var dupNode = node.cloneNode([deep]); -
-
node
-
Le noeud à dupliquer.
-
dupNode
-
Le nouveau noeud qui sera un clone du node.
-
deep {{optional_inline}} (profondeur)
-
true (vrai) si les enfants du noeud doivent aussi être clonés ou false (faux) si seul le noeud spécifié doit l'être.
-
+- node + - : Le noeud à dupliquer. +- dupNode + - : Le nouveau noeud qui sera un clone du `node`. +- deep _{{optional_inline}} (profondeur)_ + - : `true` (_vrai_) si les enfants du noeud doivent aussi être clonés ou `false` (_faux_) si seul le noeud spécifié doit l'être. -
-

Note : Dans la spécification DOM4 (telle qu'implémentée dans Gecko 13.0 {{geckoRelease(13)}}), deep est un argument facultatif. S'il est omis, la méthode agit comme si la valeur de  deep était true par défaut, elle utilise le clonage profond comme comportement par défaut. Pour créer un clone superficiel, deep doit être défini sur false.

+> **Note :** Dans la spécification DOM4 (telle qu'implémentée dans Gecko 13.0 {{geckoRelease(13)}}), `deep` est un argument facultatif. S'il est omis, la méthode agit comme si la valeur de  `deep` était **`true`** par défaut, elle utilise le clonage profond comme comportement par défaut. Pour créer un clone superficiel, `deep` doit être défini sur `false`. +> +> Le comportement a été modifié dans la dernière spécification et, s'il est omis, la méthode doit agir comme si la valeur de `deep` était **`false`**. Bien que ce soit toujours facultatif, vous devriez toujours fournir l'argument `deep` pour la compatibilité amont et aval. Avec Gecko 28.0 {{geckoRelease(28)}}), la console a averti les développeurs de ne pas omettre l'argument. À partir de Gecko 29.0 {{geckoRelease(29)}}), un clone superficiel est défini par défaut au lieu d'un clone profond. -

Le comportement a été modifié dans la dernière spécification et, s'il est omis, la méthode doit agir comme si la valeur de deep était false. Bien que ce soit toujours facultatif, vous devriez toujours fournir l'argument deep pour la compatibilité amont et aval. Avec Gecko 28.0 {{geckoRelease(28)}}), la console a averti les développeurs de ne pas omettre l'argument. À partir de Gecko 29.0 {{geckoRelease(29)}}), un clone superficiel est défini par défaut au lieu d'un clone profond.

-
+## Exemple -

Exemple

+ p = document.getElementById("para1"); + p_prime = p.cloneNode(true); -
p = document.getElementById("para1");
-p_prime = p.cloneNode(true);
-
+## Notes -

Notes

+Cloner un nœud copie tous ses attributs ainsi que leurs valeurs, y compris les auditeurs intrinsèques (en ligne). Il ne copie pas les auditeurs d'évènement ajoutés avec [`addEventListener()`](/en-US/docs/DOM/element.addEventListener) ou ceux assignés au propriétés d'éléments (par exemple `node.onclick = fn`). De plus, pour un élément {{HTMLElement("canvas")}} l'image peinte n'est pas copiée. -

Cloner un nœud copie tous ses attributs ainsi que leurs valeurs, y compris les auditeurs intrinsèques (en ligne). Il ne copie pas les auditeurs d'évènement ajoutés avec addEventListener() ou ceux assignés au propriétés d'éléments (par exemple node.onclick = fn). De plus, pour un élément {{HTMLElement("canvas")}} l'image peinte n'est pas copiée.

+Le nœud dupliqué renvoyé par `cloneNode` ne fera pas partie du document tant qu'il n'y est pas ajouté via la méthode {{domxref("Node.appendChild()")}} ou une méthode similaire. De même, il n'a pas de parent tant qu'il n'a pas été ajouté à un autre nœud. -

Le nœud dupliqué renvoyé par cloneNode ne fera pas partie du document tant qu'il n'y est pas ajouté via la méthode {{domxref("Node.appendChild()")}} ou une méthode similaire. De même, il n'a pas de parent tant qu'il n'a pas été ajouté à un autre nœud.

+Si `deep` est défini à `false`, aucun des nœuds enfants n'est copié. +*T*out texte contenu dans le nœud n'est pas copié non plus , car il fait partie d'un ou plusieurs nœuds {{domxref("Text")}} enfants. -

Si deep est défini à false, aucun des nœuds enfants n'est copié.
- Tout texte contenu dans le nœud n'est pas copié non plus , car il fait partie d'un ou plusieurs nœuds {{domxref("Text")}} enfants.

+Si `deep` est évalué à `true`, le sous-arbre entier est copié également (y compris le texte qui peut être contenu dans des nœuds {{domxref("Text")}} enfants). Pour les nœuds vides (par exemple les éléments {{HTMLElement("img")}} et {{HTMLElement("input")}} ) le fait de mettre `deep` à `true` ou `false` n'a aucune incidence sur la copie, mais il est tout de même nécessaire de fournir une valeur. -

Si deep est évalué à true, le sous-arbre entier est copié également (y compris le texte qui peut être contenu dans des nœuds {{domxref("Text")}} enfants). Pour les nœuds vides (par exemple les éléments {{HTMLElement("img")}} et {{HTMLElement("input")}} ) le fait de mettre deep à true ou false n'a aucune incidence sur la copie, mais il est tout de même nécessaire de fournir une valeur.

+> **Attention :** `cloneNode()` peut conduire à dupliquer des ID (_identifiant_) d'éléments dans un document. -
-

Attention : cloneNode() peut conduire à dupliquer des ID (identifiant) d'éléments dans un document.

-
+Si le noeud d'origine a un identifiant et que le clone doit être placé dans le même document, l'identifiant du clone peut être modifié pour être unique. Les attributs du nom peuvent devoir être modifiés également, selon que les noms en double sont attendus. -

Si le noeud d'origine a un identifiant et que le clone doit être placé dans le même document, l'identifiant du clone peut être modifié pour être unique. Les attributs du nom peuvent devoir être modifiés également, selon que les noms en double sont attendus.

+Pour cloner un noeud à ajouter dans un document différent, utilisez  {{domxref("Document.importNode()")}} à la place. -

Pour cloner un noeud à ajouter dans un document différent, utilisez  {{domxref("Document.importNode()")}} à la place.

+### Spécification -

Spécification

+| Spécification | Statut | Commentaire | +| -------------------------------------------------------------------------------------------- | -------------------------------- | ------------------- | +| {{SpecName("DOM WHATWG", "#dom-node-clonenode", "Node.cloneNode()")}} | {{Spec2("DOM WHATWG")}} |   | +| {{SpecName("DOM3 Core", "core.html#ID-3A0ED0A4", "Node.cloneNode()")}} | {{Spec2("DOM3 Core")}} |   | +| {{SpecName("DOM2 Core", "core.html#ID-3A0ED0A4", "Node.cloneNode()")}} | {{Spec2("DOM2 Core")}} | Définition initiale | - - - - - - - - - - - - - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName("DOM WHATWG", "#dom-node-clonenode", "Node.cloneNode()")}}{{Spec2("DOM WHATWG")}} 
{{SpecName("DOM3 Core", "core.html#ID-3A0ED0A4", "Node.cloneNode()")}}{{Spec2("DOM3 Core")}} 
{{SpecName("DOM2 Core", "core.html#ID-3A0ED0A4", "Node.cloneNode()")}}{{Spec2("DOM2 Core")}}Définition initiale
+## Compatibilité des navigateurs -

Compatibilité des navigateurs

- -

{{Compat("api.Node.cloneNode")}}

+{{Compat("api.Node.cloneNode")}} diff --git a/files/fr/web/api/node/comparedocumentposition/index.md b/files/fr/web/api/node/comparedocumentposition/index.md index a40125b5c1..21bc78963d 100644 --- a/files/fr/web/api/node/comparedocumentposition/index.md +++ b/files/fr/web/api/node/comparedocumentposition/index.md @@ -10,99 +10,52 @@ tags: - Position translation_of: Web/API/Node/compareDocumentPosition --- -
{{APIRef("DOM")}}
- -

La méthode Node.compareDocumentPosition()compare la position du noeud courant par rapport à un autre noeud dans tout autre document.

- -

La valeur retournée est un masque de bits avec les valeurs suivantes :

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
NomValeur
DOCUMENT_POSITION_DISCONNECTED1
DOCUMENT_POSITION_PRECEDING2
DOCUMENT_POSITION_FOLLOWING4
DOCUMENT_POSITION_CONTAINS8
DOCUMENT_POSITION_CONTAINED_BY16
DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC32
- -

Syntaxe

- -
node.compareDocumentPosition( otherNode )
-
- -

Exemple

- -
var head = document.getElementsByTagName('head').item(0);
-
-if (head.compareDocumentPosition(document.body) & Node.DOCUMENT_POSITION_FOLLOWING) {
+{{APIRef("DOM")}}
+
+La méthode **`Node.compareDocumentPosition()`**compare la position du noeud courant par rapport à un autre noeud dans tout autre document.
+
+La valeur retournée est un masque de bits avec les valeurs suivantes :
+
+| Nom                                         | Valeur |
+| ------------------------------------------- | ------ |
+| `DOCUMENT_POSITION_DISCONNECTED`            | 1      |
+| `DOCUMENT_POSITION_PRECEDING`               | 2      |
+| `DOCUMENT_POSITION_FOLLOWING`               | 4      |
+| `DOCUMENT_POSITION_CONTAINS`                | 8      |
+| `DOCUMENT_POSITION_CONTAINED_BY`            | 16     |
+| `DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC` | 32     |
+
+## Syntaxe
+
+    node.compareDocumentPosition( otherNode )
+
+## Exemple
+
+```js
+var head = document.getElementsByTagName('head').item(0);
+
+if (head.compareDocumentPosition(document.body) & Node.DOCUMENT_POSITION_FOLLOWING) {
   console.log("well-formed document");
 } else {
-  console.log("<head> is not before <body>");
+  console.log(" is not before ");
 }
-
- -
-

Note : Parce que le résultat renvoyé par compareDocumentPosition est un masque de bits, des opérateurs binaires doivent être utilisés pour des résultats significatifs.

-
- -
-

Note : La première instruction utilise l' item(0) de la méthode NodeList , qui est l'équivalent de getElementsByTagName('head')[0].

-
- -

Spécifications

- - - - - - - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('DOM WHATWG','#dom-node-comparedocumentposition','Node.compareDocumentPosition()')}}{{Spec2('DOM WHATWG')}} 
{{SpecName('DOM3 Core','core.html#Node3-compareDocumentPosition','Node.compareDocumentPosition()')}}{{Spec2('DOM3 Core')}}Définition initiale
- -

Compatibilité des navigateurs

- -

{{Compat("api.Node.compareDocumentPosition")}}

- -

Voir aussi

- - +``` + +> **Note :** Parce que le résultat renvoyé par\* \*`compareDocumentPosition` est un masque de bits, des [opérateurs binaires](/fr/docs/Web/JavaScript/Reference/Op%C3%A9rateurs/Op%C3%A9rateurs_binaires) doivent être utilisés pour des résultats significatifs. + +> **Note :** La première instruction utilise l' `item(0)` de la méthode [NodeList](/en-US/docs/Web/API/NodeList/item) , qui est l'équivalent de `getElementsByTagName('head')[0].` + +## Spécifications + +| Spécification | Statut | Commentaire | +| ------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------- | ------------------- | +| {{SpecName('DOM WHATWG','#dom-node-comparedocumentposition','Node.compareDocumentPosition()')}} | {{Spec2('DOM WHATWG')}} |   | +| {{SpecName('DOM3 Core','core.html#Node3-compareDocumentPosition','Node.compareDocumentPosition()')}} | {{Spec2('DOM3 Core')}} | Définition initiale | + +## Compatibilité des navigateurs + +{{Compat("api.Node.compareDocumentPosition")}} + +## Voir aussi + +- [`Node.contains`](/fr/docs/Web/API/Node/contains) diff --git a/files/fr/web/api/node/contains/index.md b/files/fr/web/api/node/contains/index.md index e5906fbf28..ae386427c2 100644 --- a/files/fr/web/api/node/contains/index.md +++ b/files/fr/web/api/node/contains/index.md @@ -9,49 +9,33 @@ tags: - Noeuds translation_of: Web/API/Node/contains --- -
{{APIRef("DOM")}}
+{{APIRef("DOM")}}La méthode **`Node.contains()`** renvoie une valeur {{jsxref("Boolean")}} (_booléenne_) indiquant si un nœud est un descendant d'un nœud donné, c'est-à-dire le nœud lui-même, l'un de ses enfants directs ({{domxref("Node.childNodes", "childNodes")}}), l'un des enfants directs des enfants, et ainsi de suite. -
La méthode Node.contains() renvoie une valeur {{jsxref("Boolean")}} (booléenne) indiquant si un nœud est un descendant d'un nœud donné, c'est-à-dire le nœud lui-même, l'un de ses enfants directs ({{domxref("Node.childNodes", "childNodes")}}), l'un des enfants directs des enfants, et ainsi de suite.
+## Syntaxe -

Syntaxe

+ node.contains( otherNode ) -
node.contains( otherNode )
-
+## Exemple -

Exemple

+Cette fonction vérifie si un élément est dans le corps de la page. Comme `contains` est inclusif, déterminer si le corps est contenu en lui-même n'est pas le but de `isInPage,` donc ce cas renvoie `false`. -

Cette fonction vérifie si un élément est dans le corps de la page. Comme contains est inclusif, déterminer si le corps est contenu en lui-même n'est pas le but de isInPage, donc ce cas renvoie false.

- -
function isInPage(node) {
+```js
+function isInPage(node) {
   return (node === document.body) ? false : document.body.contains(node);
-}
- -

Spécifications

- - - - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName("DOM WHATWG", "#dom-node-contains", "Node.contains()")}}{{Spec2("DOM WHATWG")}}Définition initiale
- -

Compatibilité des navigateurs

- -

{{Compat("api.Node.contains")}}

- -

Voir aussi

- - +} +``` + +## Spécifications + +| Spécification | Statut | Commentaire | +| ---------------------------------------------------------------------------------------- | -------------------------------- | ------------------- | +| {{SpecName("DOM WHATWG", "#dom-node-contains", "Node.contains()")}} | {{Spec2("DOM WHATWG")}} | Définition initiale | + +## Compatibilité des navigateurs + +{{Compat("api.Node.contains")}} + +## Voir aussi + +- {{domxref("Node.compareDocumentPosition")}} +- {{domxref("Node.hasChildNodes")}} diff --git a/files/fr/web/api/node/firstchild/index.md b/files/fr/web/api/node/firstchild/index.md index 03550acf9f..02a1edd488 100644 --- a/files/fr/web/api/node/firstchild/index.md +++ b/files/fr/web/api/node/firstchild/index.md @@ -9,80 +9,57 @@ tags: - Propriété translation_of: Web/API/Node/firstChild --- -

{{APIRef("DOM")}}

+{{APIRef("DOM")}} -

La propriété en lecture seule Node.firstChild renvoie le premier nœud enfant de l'arbre ou null s'il n'en a pas. Si le noeud est un Document , il renvoie le premier noeud de la liste de ses enfants directs.

+La propriété en lecture seule **`Node.firstChild` r**envoie le premier nœud enfant de l'arbre ou `null` s'il n'en a pas. Si le noeud est un `Document` , il renvoie le premier noeud de la liste de ses enfants directs. -

Syntaxe

+## Syntaxe -
var childNode = node.firstChild;
+ var childNode = node.firstChild; -

Exemple

+## Exemple -

Cet exemple montre l'utilisation de firstChild et la manière dont les nœuds d'espaces peuvent interférer.

+Cet exemple montre l'utilisation de `firstChild` et la manière dont les nœuds d'espaces peuvent interférer. -
<p id="para-01">
-  <span>Premier span</span>
-</p>
+```html
+

+ Premier span +

-<script type="text/javascript"> + +``` -

Dans le code ci-dessus, la console affichera « #text » car un nœud texte a été inséré pour préserver les blancs entre la fin des balises ouvrantes <p> et <span>. Tout espace provoquera l'insertion d'un nœud #text , qu'il s'agisse d'un simple espace ou de plusieurs, de retours à la ligne, tabulations, etc.

+Dans le code ci-dessus, la [console](/fr/docs/Web/API/Console) affichera « #text » car un nœud texte a été inséré pour préserver les blancs entre la fin des balises ouvrantes \

et \. **Tout** [espace](/fr/docs/Gestion_des_espaces_dans_le_DOM) provoquera l'insertion d'un nœud `#text` , qu'il s'agisse d'un simple espace ou de plusieurs, de retours à la ligne, tabulations, etc. -

Un autre nœud #text est inséré entre les balises de fermeture </span> et </p>.

+Un autre nœud `#text` est inséré entre les balises de fermeture \ et \

. -

Si ces espaces sont retirés du code source, les nœuds #text n'apparaîtront plus et l'élément span deviendra le premier enfant du paragraphe.

+Si ces espaces sont retirés du code source, les nœuds `#text` n'apparaîtront plus et l'élément span deviendra le premier enfant du paragraphe. -
<p id="para-01"><span>Premier span</span></p>
+```html
+

Premier span

-<script type="text/javascript"> + +``` + +À présent, l'alerte affichera « SPAN ». + +Pour éviter le problème avec `node.firstChild`  renvoyant des noeuds `#text` ou `#comment`,  {{domxref("ParentNode.firstElementChild")}}  peut être utilisé pour renvoyer seulement le premier noeud élément. Toutefois,  `node.firstElementChild` nécessite un "shim" pour Internet Explorer 9 et antérieurs. + +## Spécification + +| Spécification | Statut | Commentaire | +| ---------------------------------------------------------------------------------------------------- | -------------------------------- | ------------------- | +| {{SpecName('DOM WHATWG', '#dom-node-firstchild', 'Node.firstChild')}} | {{Spec2('DOM WHATWG')}} | Pas de changement | +| {{SpecName('DOM3 Core', 'core.html#ID-169727388', 'Node.firstChild')}} | {{Spec2('DOM3 Core')}} | Pas de changement | +| {{SpecName('DOM2 Core', 'core.html#ID-169727388', 'Node.firstChild')}} | {{Spec2('DOM2 Core')}} | Pas de changement | +| {{SpecName('DOM1', 'level-one-core.html#ID-169727388', 'Node.firstChild')}} | {{Spec2('DOM1')}} | Définition initiale | + +## Compatibilité des navigateurs + +{{Compat("api.Node.firstChild")}} diff --git a/files/fr/web/api/node/getrootnode/index.md b/files/fr/web/api/node/getrootnode/index.md index 5a6297d55b..9170ad233a 100644 --- a/files/fr/web/api/node/getrootnode/index.md +++ b/files/fr/web/api/node/getrootnode/index.md @@ -9,43 +9,43 @@ tags: - Racine translation_of: Web/API/Node/getRootNode --- -

{{APIRef("DOM")}}

+{{APIRef("DOM")}} -

La méthode getRootNode() de l'interface {{domxref("Node")}} renvoie le contexte de la racine de l'objet, qui peut optionnellement inclure la racine "shadow" si elle est disponible.

+La méthode **`getRootNode()`** de l'interface {{domxref("Node")}} renvoie le contexte de la racine de l'objet, qui peut optionnellement inclure la racine "shadow" si elle est disponible. -

Syntaxe

+## Syntaxe -
var root = node.getRootNode(options)
+ var root = node.getRootNode(options) -

Paramètres

+### Paramètres -
-
options {{optional_inline}}
-
Un objet qui définit les options pour obtenir le noeud racine. Les options disponibles sont : -
    -
  • composed : un {{jsxref('Boolean')}} (booléen) qui indique si la racine shadow doit être retournée (false (faux) par défaut) ou un noeud racine au-delà de la racine shadow (true).
  • -
-
-
+- options {{optional_inline}} -

Retourne

+ - : Un objet qui définit les options pour obtenir le noeud racine. Les options disponibles sont : -

Une interface {{domxref('Node')}}.

+ - `composed` : un {{jsxref('Boolean')}} (_booléen_) qui indique si la racine shadow doit être retournée (`false` (_faux_) par défaut) ou un noeud racine au-delà de la racine shadow (`true`). -

Exemple

+### Retourne -

Le premier exemple retourne une référence au noeud HTML/document lorsqu'il est exécuté dans les navigateurs de support :

+Une interface {{domxref('Node')}}. -
rootNode = node.getRootNode();
+## Exemple -

Cet exemple plus complexe montre la différence entre retourner une racine normale et une racine qui inclut la racine shadow (voir le code source complet):

+Le premier exemple retourne une référence au noeud HTML/document lorsqu'il est exécuté dans les navigateurs de support : -
<!-- source: https://github.com/jserz/js_piece/blob/master/DOM/Node/getRootNode()/demo/getRootNode.html -->
-<div class="js-parent">
-    <div class="js-child"></div>
-</div>
-<div class="js-shadowHost"></div>
-<script>
+```js
+rootNode = node.getRootNode();
+```
+
+Cet exemple plus complexe montre la différence entre retourner une racine normale et une racine qui inclut la racine shadow (voir le [code source complet]()):
+
+```html
+
+
+
+
+
+ +``` + +## Spécifications + +| Spécification | Statut | Commentaire | +| ---------------------------------------------------------------------------------------- | -------------------------------- | -------------------- | +| {{SpecName('DOM WHATWG','#dom-node-getrootnode','getRootNode()')}} | {{Spec2('DOM WHATWG')}} | Définition initiale. | + +## Compatibilité des navigateurs + +{{Compat("api.Node.getRootNode")}} diff --git a/files/fr/web/api/node/haschildnodes/index.md b/files/fr/web/api/node/haschildnodes/index.md index c14ad9836f..54fd502016 100644 --- a/files/fr/web/api/node/haschildnodes/index.md +++ b/files/fr/web/api/node/haschildnodes/index.md @@ -10,69 +10,57 @@ tags: - Reference translation_of: Web/API/Node/hasChildNodes --- -

{{APIRef("DOM")}}

+{{APIRef("DOM")}} -

La méthode Node.hasChildNodes() renvoie un {{jsxref("Boolean")}} indiquant si le {{domxref("Node","noeud")}} actuel possède des nœuds enfants ou non.

+La méthode **`Node.hasChildNodes()`** renvoie un {{jsxref("Boolean")}} indiquant si le {{domxref("Node","noeud")}} actuel possède des [nœuds enfants](/fr/docs/Web/API/Node/childNodes) ou non. -

Syntaxe

+## Syntaxe -
bool = node.hasChildNodes();
+```js +bool = node.hasChildNodes(); +``` -

Valeur de retour

+### Valeur de retour -

Un {{jsxref("Boolean")}} qui est true si le nœud a des nœuds enfants, et false dans le cas contraire.

+Un {{jsxref("Boolean")}} qui est `true` si le nœud a des nœuds enfants, et `false` dans le cas contraire. -

Exemple

+## Exemple -
let foo = document.getElementById('foo');
+```js
+let foo = document.getElementById('foo');
 
 if (foo.hasChildNodes()) {
   // Faire quelque chose avec 'foo.childNodes'
-}
+} +``` -

Prothèse d'émulation

+## Prothèse d'émulation -
(function(prototype) {
+```js
+(function(prototype) {
   prototype.hasChildNodes = prototype.hasChildNodes || function() {
     return !!this.firstChild;
   }
-})(Node.prototype);
- -

Il y a différentes façons de déterminer si le noeud a un noeud enfant :

- -
    -
  • node.hasChildNodes()
  • -
  • node.firstChild != null (ou simplement node.firstChild)
  • -
  • node.childNodes && node.childNodes.length (ou node.childNodes.length > 0)
  • -
- -

Spécification

- - - - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName("DOM WHATWG", "#dom-node-haschildnodes", "Node: hasChildNodes")}} - {{Spec2("DOM WHATWG")}}
- -

Compatibilité des navigateurs

- -

{{Compat("api.Node.hasChildNodes")}}

- -

Voir aussi

- -
    -
  • {{domxref("Node.childNodes")}}
  • -
  • {{domxref("Node.hasAttributes")}}
  • -
+})(Node.prototype); +``` + +Il y a différentes façons de déterminer si le noeud a un noeud enfant : + +- `node.hasChildNodes()` +- `node.firstChild != null` (ou simplement `node.firstChild`) +- `node.childNodes && node.childNodes.length` (ou `node.childNodes.length > 0`) + +## Spécification + +| Spécification | Statut | Commentaire | +| ---------------------------------------------------------------------------------------------------- | -------------------------------- | ----------- | +| {{SpecName("DOM WHATWG", "#dom-node-haschildnodes", "Node: hasChildNodes")}} | {{Spec2("DOM WHATWG")}} | | + +## Compatibilité des navigateurs + +{{Compat("api.Node.hasChildNodes")}} + +## Voir aussi + +- {{domxref("Node.childNodes")}} +- {{domxref("Node.hasAttributes")}} diff --git a/files/fr/web/api/node/index.md b/files/fr/web/api/node/index.md index 4c7ddde36b..624d732fe0 100644 --- a/files/fr/web/api/node/index.md +++ b/files/fr/web/api/node/index.md @@ -13,294 +13,208 @@ tags: - hierarchy translation_of: Web/API/Node --- -

{{ApiRef("DOM")}}

- -

Node (nœud) est une classe abstraite de laquelle de nombreux objets de type DOM API héritent, leur permettant d'être traités de manière similaire et souvent interchangeable. Étant une classe abstraire, il n'existe pas d'objet qui soit directement un Node. Tous les objets implantant les fonctionnalités de Node sont des instances d'une de ses sous-classes, dont les plus notables sont {{domxref("Document")}}, {{domxref("Element")}} et {{domxref("DocumentFragment")}}.

- -

De pls, tous les types de nœuds du DOM sont représentés par une classe héritant des propriétés et méthodes de Node : {{domxref("CharacterData")}} (duquel {{domxref("Text")}}, {{domxref("Comment")}} et {{domxref("CDATASection")}} héritent), {{domxref("ProcessingInstruction")}}, , {{domxref("DocumentType")}}, {{domxref("Notation")}}, {{domxref("Entity")}} et {{domxref("EntityReference")}}.

- -

Les propriétés ou méthodes de ces interfaces peuvent retourner null lorsque leur existence n'est pas pertinente. Elles peuvent aussi générer une exception – par exemple lors de l'ajout d'un enfant à un type de nœud pour lequel aucun enfant ne peut exister.

- -

{{InheritanceDiagram}}

- -

Propriétés

- -

Hérite les propriétés de son parent {{domxref("EventTarget")}}.

- -
-
{{DOMxRef("Node.baseURI")}} {{readonlyInline}}
-
Retourne une {{domxref("DOMString")}} (chaine de caractères) représentant l'URL de base du document contenant le Node. En HTML, il correspond au protocole, au nom de domaine et à la structure du répertoire, jusqu'au dernier /.
-
{{DOMxRef("Node.baseURIObject")}} {{Non-standard_inline()}}
-
(Non disponible pour le contenu Web). L'objet en lecture seule {{Interface ("nsIURI")}} représentant l'URI de base pour l'élément.
-
{{DOMxRef("Node.childNodes")}} {{readonlyInline}}
-
Renvoie un {{domxref ("NodeList")}} contenant tous les enfants de ce nœud. {{domxref ("NodeList")}} signifie que si les enfants du Node changent, l'objet {{domxref ("NodeList")}} est automatiquement mis à jour.
-
{{DOMxRef("Node.firstChild")}} {{readonlyInline}}
-
Renvoie un {{domxref ("Node")}} représentant le premier nœud enfant direct de ce nœud ou null s'il n'a pas d'enfant.
-
{{DOMxRef("Node.lastChild")}} {{readonlyInline}}
-
Retourne un {{domxref("Node")}} représentant le dernier nœud enfant direct de ce nœud ou null s'il n'a pas d'enfant.
-
{{DOMxRef("Node.nextSibling")}} {{readonlyInline}}
-
Retourne un {{domxref("Node")}} représentant le nœud suivant dans l'arbre ou null s'il n'y en a pas.
-
{{DOMxRef("Node.nodeName")}} {{readonlyInline}}
-
Retourne une {{domxref("DOMString")}} (chaîne de caractères) contenant le nom du nœud. La structure du nom diffère du type de nœud. Par exemple, un {{domxref("HTMLElement")}} contiendra le nom de la balise correspondante, comme 'audio'  pour un {{domxref("HTMLAudioElement")}}, un nœud {{domxref("Text")}} doit avoir la chaîne '#text' ou un  {{domxref("Document")}}  doit avoir la chaîne '#document'..
-
{{DOMxRef("Node.nodeType")}}{{readonlyInline}}
-
Retourne un unsigned short (non signé court) représentant le type du nœud. Les valeurs possibles sont :
-
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
NomValeur
ELEMENT_NODE1
ATTRIBUTE_NODE {{deprecated_inline()}}2
TEXT_NODE3
CDATA_SECTION_NODE {{deprecated_inline()}}4
ENTITY_REFERENCE_NODE {{deprecated_inline()}}5
ENTITY_NODE {{deprecated_inline()}}6
PROCESSING_INSTRUCTION_NODE7
COMMENT_NODE8
DOCUMENT_NODE9
DOCUMENT_TYPE_NODE10
DOCUMENT_FRAGMENT_NODE11
NOTATION_NODE {{deprecated_inline()}}12
- -
-
{{DOMxRef("Node.nodeValue")}}
-
Retourne / définit la valeur du nœud courant.
-
{{DOMxRef("Node.ownerDocument")}}{{readonlyInline}}
-
Retourne le {{domxref("Document")}}  auquel ce noeud appartient. Si aucun document ne lui est associé, il retourne null .
-
{{DOMxRef("Node.parentNode")}}{{readonlyInline}}
-
Retourne un {{domxref("Node")}} qui est le parent de ce nœud. S'il n'existe pas, parce qu'il est en haut de l'arbre ou parce qu'il ne participe pas à un arbre, cette propriété retourne null .
-
{{DOMxRef("Node.parentElement")}}{{readonlyInline}}
-
Retourne un {{domxref("Element")}} qui est le parent de ce nœud. Si le nœud n'a aucun parent ou si ce parent n'est pas un  {{domxref("Element")}} , cette propriété retourne null.
-
{{DOMxRef("Node.previousSibling")}}{{readonlyInline}}
-
Retourne un {{domxref("Node")}} représentant le nœud précédent dans l'arbre ou  null s'il n'y en a pas.
-
{{DOMxRef("Node.textContent")}}
-
Retourne / définit le contenu textuel d'un élément et de tous ses descendants.
-
- -
-
- -

Propriétés obsolètes

- -
-
{{DOMxRef("Node.localName")}} {{obsolete_inline}}{{readonlyInline}}
-
Retourne un {{domxref("DOMString")}}  représentant la partie locale du nom d'un élément.
-
- -
-

Note : Dans Firefox 3.5 et versions antérieures, la propriété saisit le nom local pour les éléments HTML (mais pas les éléments XHTML). Dans les versions ultérieures, cela ne se produit pas, donc la propriété est en minuscule pour HTML et XHTML. {{gecko_minversion_inline("1.9.2")}}

-
- -
-
{{DOMxRef("Node.namespaceURI")}} {{obsolete_inline}}{{readonlyInline}}
-
L'URI du "Namespace" de ce nom, ou  null s'il n'y en a pas.
-
- -
-

Note : Dans Firefox 3.5 et versions antérieures, les éléments HTML ne contiennent aucun "namespace". Dans les versions ultérieures, les éléments HTML sont dans le "namespace" https://www.w3.org/1999/xhtml/  pour HTML et XML.  {{gecko_minversion_inline("1.9.2")}}

-
- -
-
{{DOMxRef("Node.prefix")}} {{obsolete_inline}}{{readonlyInline}}
-
Est une {{domxref("DOMString")}} représentant le préfixe de l'espace de nom du nœud ou null  si aucun préfixe n'est spécifié.
-
{{DOMxRef("Node.nodePrincipal")}} {{Non-standard_inline}}{{Obsolete_Inline("gecko46")}}
-
Un {{Interface("nsIPrincipal")}} représentant le nœud principal.
-
{{DOMxRef("Node.rootNode")}} {{Obsolete_Inline}}{{ReadOnlyInline}}
-
Retourne un objet {{DOMxRef("Node")}} représentant le noeud le plus haut dans l'arbre ou le noeud en cours s'il est le noeud le plus haut de l'arbre. Cette propriété a été remplacée par {{DOMxRef("Node.getRootNode()")}}.
-
- -

Méthodes

- -

Hérite des méthodes de son parent {{domxref("EventTarget")}}.

- -
-
{{DOMxRef("Node.appendChild()", "Node.appendChild(childNode)")}}
-
Ajoute l'argument childNode spécifié comme dernier enfant au noeud actuel.
- Si l'argument fait référence à un noeud existant sur l'arborescence DOM, le nœud sera détaché de sa position actuelle et attaché à la nouvelle position.
-
{{DOMxRef("Node.cloneNode()")}}
-
Clône un {{domxref("Node")}} et, éventuellement, tout son contenu. Par défaut, il duplique le contenu de ce nœud.
-
{{DOMxRef("Node.compareDocumentPosition()")}}
-
Compare la position du nœud courant par rapport à un autre nœud dans tout autre document.
-
{{DOMxRef("Node.contains()")}}
-
Retourne une valeur {{jsxref("Boolean")}} (booléen) indiquant si un noeud est un descendant d'un noeud donné ou non.
-
{{domxref("Node.getBoxQuads()")}} {{experimental_inline}}
-
Retourne une liste des boites CSS des nœuds relatifs à un autre nœud.
-
{{DOMxRef("Node.getRootNode()")}}
-
Retourne la racine de l'objet contextuel qui comprend éventuellement la "Shadow root" si elle est disponible.
-
{{DOMxRef("Node.hasChildNodes()")}}
-
Retourne un {{jsxref("Boolean")}} (booléen) indiquant si l'élément a des noeuds enfants ou non.
-
{{DOMxRef("Node.insertBefore()")}}
-
Insère un {{domxref("Node")}} avant le nœud de référence en tant qu'enfant du noeud actuel.
-
{{DOMxRef("Node.isDefaultNamespace()")}}
-
Accepte une URI d'espace de nom comme argument et retourne une valeur {{jsxref("Boolean")}} avec true (vrai) si l'espace de nom est celui par défaut du noeud donné ou false (faux) sinon.
-
{{DOMxRef("Node.isEqualNode()")}}
-
Retourne une valeur {{jsxref("Boolean")}} (booléenne) qui indique si oui ou non deux noeuds sont du même type et si tous leurs points de données définis correspondent.
-
{{DOMxRef("Node.isSameNode()")}}
-
Retourne une valeur {{jsxref("Boolean")}} (booléenne) indiquant si les deux noeuds sont ou non identiques (c'est-à-dire qu'ils font référence au même objet).
-
{{DOMxRef("Node.lookupPrefix()")}}
-
Retourne une {{domxref("DOMString")}} (chaîne de caractères) contenant le préfixe d'une URI d'un espace de nom donné, s'il est présent, et null sinon.
-
{{DOMxRef("Node.lookupNamespaceURI()")}}
-
Accepte un préfixe et retourne l'URI de l'espace de noms qui lui est associé sur le nœud donné s'il le trouve, null sinon. Fournir null comme préfixe retournera l'espace de noms par défaut.
-
{{DOMxRef("Node.normalize()")}}
-
Nettoye tous les nœuds de texte en-dessous de cet élément (fusionne adjacent, supprime vide).
-
{{DOMxRef("Node.removeChild()")}}
-
Supprime un nœud enfant, depuis l'élément courant, qui doit être un enfant de ce nœud.
-
{{DOMxRef("Node.replaceChild()")}}
-
Remplace un {{domxref("Node")}} enfant du nœud courant par celui donné dans le paramètre.
-
- -

Méthodes obsolètes

- -
-
{{domxref("Node.getFeature()")}} {{obsolete_inline}}
-
Permet à un utilisateur d'obtenir un objet {{DOMxRef("DOMUserData")}} à partir du nœud fourni.
-
{{domxref("Node.getUserData()")}} {{obsolete_inline}}
-
Permet à un utilisateur d'obtenir une {{domxref ("DOMUserData")}} (donnée utilisateur) à partir du nœud.
-
{{domxref("Node.hasAttributes()")}} {{obsolete_inline}}
-
Retourne un {{jsxref("Boolean")}} indiquant si l'élément possède des attributs ou non.
-
{{domxref("Node.isSupported()")}} {{obsolete_inline}}
-
Retourne une marque {{jsxref("Boolean")}} qui contient le résultat d'un test si l'implémentation DOM prend en compte une caractéristique spécifique et si cette fonctionnalité est prise en charge par le nœud spécifique.
-
{{domxref("Node.setUserData()")}} {{obsolete_inline}}
-
Permet à un utilisateur d'attacher ou d'enlever  {{domxref("DOMUserData")}} du nœud.
-
- -

Exemples

- -

Parcourir tous les nœuds enfants

- -

La fonction suivante parcourt de manière récursive tous les nœuds enfants d'un noeud et exécute une fonction de rappel sur eux (et sur le nœud parent lui-même).

- -
function DOMComb (oParent, oCallback) {
+{{ApiRef("DOM")}}
+
+**`Node`** (_nœud)_ est une classe abstraite de laquelle de nombreux objets de type DOM API héritent, leur permettant d'être traités de manière similaire et souvent interchangeable. Étant une classe abstraire, il n'existe pas d'objet qui soit directement un `Node`. Tous les objets implantant les fonctionnalités de `Node` sont des instances d'une de ses sous-classes, dont les plus notables sont {{domxref("Document")}}, {{domxref("Element")}} et {{domxref("DocumentFragment")}}.
+
+De pls, tous les types de nœuds du DOM sont représentés par une classe héritant des propriétés et méthodes de `Node` : {{domxref("CharacterData")}} (duquel {{domxref("Text")}}, {{domxref("Comment")}} et {{domxref("CDATASection")}} héritent), {{domxref("ProcessingInstruction")}}, , {{domxref("DocumentType")}}, {{domxref("Notation")}}, {{domxref("Entity")}} et {{domxref("EntityReference")}}.
+
+Les propriétés ou méthodes de ces interfaces peuvent retourner `null` lorsque leur existence n'est pas pertinente. Elles peuvent aussi générer une exception – par exemple lors de l'ajout d'un enfant à un type de nœud pour lequel aucun enfant ne peut exister.
+
+{{InheritanceDiagram}}
+
+## Propriétés
+
+_Hérite les propriétés de son parent {{domxref("EventTarget")}}_.
+
+- {{DOMxRef("Node.baseURI")}} {{readonlyInline}}
+  - : Retourne une {{domxref("DOMString")}} (_chaine de caractères_) représentant l'URL de base du document contenant le `Node`. En HTML, il correspond au protocole, au nom de domaine et à la structure du répertoire, jusqu'au dernier `/`.
+- {{DOMxRef("Node.baseURIObject")}} {{Non-standard_inline()}}
+  - : (Non disponible pour le contenu Web). L'objet en lecture seule {{Interface ("nsIURI")}} représentant l'URI de base pour l'élément.
+- {{DOMxRef("Node.childNodes")}} {{readonlyInline}}
+  - : Renvoie un {{domxref ("NodeList")}} contenant tous les enfants de ce nœud. {{domxref ("NodeList")}} signifie que si les enfants du `Node` changent, l'objet {{domxref ("NodeList")}} est automatiquement mis à jour.
+- {{DOMxRef("Node.firstChild")}} {{readonlyInline}}
+  - : Renvoie un {{domxref ("Node")}} représentant le premier nœud enfant direct de ce nœud ou `null` s'il n'a pas d'enfant.
+- {{DOMxRef("Node.lastChild")}} {{readonlyInline}}
+  - : Retourne un {{domxref("Node")}} représentant le dernier nœud enfant direct de ce nœud ou `null` s'il n'a pas d'enfant.
+- {{DOMxRef("Node.nextSibling")}} {{readonlyInline}}
+  - : Retourne un {{domxref("Node")}} représentant le nœud suivant dans l'arbre ou `null` s'il n'y en a pas.
+- {{DOMxRef("Node.nodeName")}} {{readonlyInline}}
+  - : Retourne une {{domxref("DOMString")}} (_chaîne de caractères_) contenant le nom du nœud. La structure du nom diffère du type de nœud. Par exemple, un {{domxref("HTMLElement")}} contiendra le nom de la balise correspondante, comme `'audio'`  pour un {{domxref("HTMLAudioElement")}}, un nœud {{domxref("Text")}} doit avoir la chaîne `'#text'` ou un  {{domxref("Document")}}  doit avoir la chaîne `'#document'.`.
+- {{DOMxRef("Node.nodeType")}}{{readonlyInline}}
+  - : Retourne un `unsigned short` (_non signé court_) représentant le type du nœud. Les valeurs possibles sont :
+
+| Nom                                                      | Valeur |
+| -------------------------------------------------------- | ------ |
+| `ELEMENT_NODE`                                           | `1`    |
+| `ATTRIBUTE_NODE` {{deprecated_inline()}}        | `2`    |
+| `TEXT_NODE`                                              | `3`    |
+| `CDATA_SECTION_NODE` {{deprecated_inline()}}    | `4`    |
+| `ENTITY_REFERENCE_NODE` {{deprecated_inline()}} | `5`    |
+| `ENTITY_NODE` {{deprecated_inline()}}           | `6`    |
+| `PROCESSING_INSTRUCTION_NODE`                            | `7`    |
+| `COMMENT_NODE`                                           | `8`    |
+| `DOCUMENT_NODE`                                          | `9`    |
+| `DOCUMENT_TYPE_NODE`                                     | `10`   |
+| `DOCUMENT_FRAGMENT_NODE`                                 | `11`   |
+| `NOTATION_NODE` {{deprecated_inline()}}         | `12`   |
+
+- {{DOMxRef("Node.nodeValue")}}
+  - : Retourne / définit la valeur du nœud courant.
+- {{DOMxRef("Node.ownerDocument")}}{{readonlyInline}}
+  - : Retourne le {{domxref("Document")}}  auquel ce noeud appartient. Si aucun document ne lui est associé, il retourne `null` .
+- {{DOMxRef("Node.parentNode")}}{{readonlyInline}}
+  - : Retourne un {{domxref("Node")}} qui est le parent de ce nœud. S'il n'existe pas, parce qu'il est en haut de l'arbre ou parce qu'il ne participe pas à un arbre, cette propriété retourne `null` .
+- {{DOMxRef("Node.parentElement")}}{{readonlyInline}}
+  - : Retourne un {{domxref("Element")}} qui est le parent de ce nœud. Si le nœud n'a aucun parent ou si ce parent n'est pas un  {{domxref("Element")}} , cette propriété retourne `null`.
+- {{DOMxRef("Node.previousSibling")}}{{readonlyInline}}
+  - : Retourne un {{domxref("Node")}} représentant le nœud précédent dans l'arbre ou  `null` s'il n'y en a pas.
+- {{DOMxRef("Node.textContent")}}
+  - : Retourne / définit le contenu textuel d'un élément et de tous ses descendants.
+
+
+
+### Propriétés obsolètes
+
+- {{DOMxRef("Node.localName")}} {{obsolete_inline}}{{readonlyInline}}
+  - : Retourne un {{domxref("DOMString")}}  représentant la partie locale du nom d'un élément.
+
+> **Note :** Dans Firefox 3.5 et versions antérieures, la propriété saisit le nom local pour les éléments HTML (mais pas les éléments XHTML). Dans les versions ultérieures, cela ne se produit pas, donc la propriété est en minuscule pour HTML et XHTML. {{gecko_minversion_inline("1.9.2")}}
+
+- {{DOMxRef("Node.namespaceURI")}} {{obsolete_inline}}{{readonlyInline}}
+  - : L'URI du "Namespace" de ce nom, ou  `null` s'il n'y en a pas.
+
+> **Note :** Dans Firefox 3.5 et versions antérieures, les éléments HTML ne contiennent aucun "namespace". Dans les versions ultérieures, les éléments HTML sont dans le "namespace" [`https://www.w3.org/1999/xhtml/`](https://www.w3.org/1999/xhtml/)  pour HTML et XML.  {{gecko_minversion_inline("1.9.2")}}
+
+- {{DOMxRef("Node.prefix")}} {{obsolete_inline}}{{readonlyInline}}
+  - : Est une {{domxref("DOMString")}} représentant le préfixe de l'espace de nom du nœud ou `null`  si aucun préfixe n'est spécifié.
+- {{DOMxRef("Node.nodePrincipal")}} {{Non-standard_inline}}{{Obsolete_Inline("gecko46")}}
+  - : Un {{Interface("nsIPrincipal")}} représentant le nœud principal.
+- {{DOMxRef("Node.rootNode")}} {{Obsolete_Inline}}{{ReadOnlyInline}}
+  - : Retourne un objet {{DOMxRef("Node")}} représentant le noeud le plus haut dans l'arbre ou le noeud en cours s'il est le noeud le plus haut de l'arbre. Cette propriété a été remplacée par {{DOMxRef("Node.getRootNode()")}}.
+
+## Méthodes
+
+_Hérite des méthodes de son parent {{domxref("EventTarget")}}_.
+
+- {{DOMxRef("Node.appendChild()", "Node.appendChild(childNode)")}}
+  - : Ajoute l'argument `childNode` spécifié comme dernier enfant au noeud actuel.
+    Si l'argument fait référence à un noeud existant sur l'arborescence DOM, le nœud sera détaché de sa position actuelle et attaché à la nouvelle position.
+- {{DOMxRef("Node.cloneNode()")}}
+  - : Clône un {{domxref("Node")}} et, éventuellement, tout son contenu. Par défaut, il duplique le contenu de ce nœud.
+- {{DOMxRef("Node.compareDocumentPosition()")}}
+  - : Compare la position du nœud courant par rapport à un autre nœud dans tout autre document.
+- {{DOMxRef("Node.contains()")}}
+  - : Retourne une valeur {{jsxref("Boolean")}} (_booléen_) indiquant si un noeud est un descendant d'un noeud donné ou non.
+- {{domxref("Node.getBoxQuads()")}} {{experimental_inline}}
+  - : Retourne une liste des boites CSS des nœuds relatifs à un autre nœud.
+- {{DOMxRef("Node.getRootNode()")}}
+  - : Retourne la racine de l'objet contextuel qui comprend éventuellement la "Shadow root" si elle est disponible.
+- {{DOMxRef("Node.hasChildNodes()")}}
+  - : Retourne un {{jsxref("Boolean")}} (_booléen_) indiquant si l'élément a des noeuds enfants ou non.
+- {{DOMxRef("Node.insertBefore()")}}
+  - : Insère un {{domxref("Node")}} avant le nœud de référence en tant qu'enfant du noeud actuel.
+- {{DOMxRef("Node.isDefaultNamespace()")}}
+  - : Accepte une URI d'espace de nom comme argument et retourne une valeur {{jsxref("Boolean")}} avec `true` (_vrai_) si l'espace de nom est celui par défaut du noeud donné ou `false` (_faux_) sinon.
+- {{DOMxRef("Node.isEqualNode()")}}
+  - : Retourne une valeur {{jsxref("Boolean")}} (_booléenne_) qui indique si oui ou non deux noeuds sont du même type et si tous leurs points de données définis correspondent.
+- {{DOMxRef("Node.isSameNode()")}}
+  - : Retourne une valeur {{jsxref("Boolean")}} (_booléenne_) indiquant si les deux noeuds sont ou non identiques (c'est-à-dire qu'ils font référence au même objet).
+- {{DOMxRef("Node.lookupPrefix()")}}
+  - : Retourne une {{domxref("DOMString")}} (_chaîne de caractères_) contenant le préfixe d'une URI d'un espace de nom donné, s'il est présent, et `null` sinon.
+- {{DOMxRef("Node.lookupNamespaceURI()")}}
+  - : Accepte un préfixe et retourne l'URI de l'espace de noms qui lui est associé sur le nœud donné s'il le trouve, `null` sinon. Fournir `null` comme préfixe retournera l'espace de noms par défaut.
+- {{DOMxRef("Node.normalize()")}}
+  - : Nettoye tous les nœuds de texte en-dessous de cet élément (fusionne adjacent, supprime vide).
+- {{DOMxRef("Node.removeChild()")}}
+  - : Supprime un nœud enfant, depuis l'élément courant, qui doit être un enfant de ce nœud.
+- {{DOMxRef("Node.replaceChild()")}}
+  - : Remplace un {{domxref("Node")}} enfant du nœud courant par celui donné dans le paramètre.
+
+### Méthodes obsolètes
+
+- {{domxref("Node.getFeature()")}} {{obsolete_inline}}
+  - : Permet à un utilisateur d'obtenir un objet {{DOMxRef("DOMUserData")}} à partir du nœud fourni.
+- {{domxref("Node.getUserData()")}} {{obsolete_inline}}
+  - : Permet à un utilisateur d'obtenir une {{domxref ("DOMUserData")}} (_donnée utilisateur_) à partir du nœud.
+- {{domxref("Node.hasAttributes()")}} {{obsolete_inline}}
+  - : Retourne un {{jsxref("Boolean")}} indiquant si l'élément possède des attributs ou non.
+- {{domxref("Node.isSupported()")}} {{obsolete_inline}}
+  - : Retourne une marque {{jsxref("Boolean")}} qui contient le résultat d'un test si l'implémentation DOM prend en compte une caractéristique spécifique et si cette fonctionnalité est prise en charge par le nœud spécifique.
+- {{domxref("Node.setUserData()")}} {{obsolete_inline}}
+  - : Permet à un utilisateur d'attacher ou d'enlever  {{domxref("DOMUserData")}} du nœud.
+
+## Exemples
+
+### Parcourir tous les nœuds enfants
+
+La fonction suivante parcourt de manière récursive tous les nœuds enfants d'un noeud et exécute une fonction de rappel sur eux (et sur le nœud parent lui-même).
+
+```js
+function DOMComb (oParent, oCallback) {
   if (oParent.hasChildNodes()) {
     for (var oNode = oParent.firstChild; oNode; oNode = oNode.nextSibling) {
       DOMComb(oNode, oCallback);
     }
   }
   oCallback.call(oParent);
-}
+} +``` -

Syntaxe

+#### Syntaxe -
DOMComb(parentNode, callbackFunction);
+ DOMComb(parentNode, callbackFunction); -

Description

+#### Description -

Suit le cycle récursif de tous les nœuds enfants d'un parentNode et le parentNode lui-même, et exécute la fonction callbackFunction (rappel) sur eux comme un objet this.

+Suit le cycle récursif de tous les nœuds enfants d'un `parentNode` et le `parentNode` lui-même, et exécute la fonction `callbackFunction` (_rappel_) sur eux comme un objet [`this`](/fr/docs/Web/JavaScript/Reference/Op%C3%A9rateurs/L_op%C3%A9rateur_this). -

Paramètres

+#### Paramètres -
-
parentNode
-
Le nœud parent (Node Object)
-
callbackFunction
-
La fonction de rappel (Function).
-
+- `parentNode` + - : Le nœud parent (`Node Object`) +- `callbackFunction` + - : La fonction de rappel ([`Function`](/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function)). -

Exemples d'utilisation

+#### Exemples d'utilisation -

L'exemple suivant envoie à la console.log le contenu texte du corps :

+L'exemple suivant envoie à la `console.log` le contenu texte du corps : -
function printContent () {
+```js
+function printContent () {
   if (this.nodeValue) { console.log(this.nodeValue); }
 }
 
 onload = function () {
   DOMComb(document.body, printContent);
-};
+}; +``` -

Supprimer tous les enfants imbriqués dans un nœud

+### Supprimer tous les enfants imbriqués dans un nœud -
Element.prototype.removeAll = function () {
+```js
+Element.prototype.removeAll = function () {
   while (this.firstChild) { this.removeChild(this.firstChild); }
   return this;
-};
- -

Exemple d'utilisation

- -
/* ... an alternative to document.body.innerHTML = "" ... */
-document.body.removeAll();
- -

Spécifications

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('DOM WHATWG', '#interface-node', 'Node')}}{{Spec2('DOM WHATWG')}}Supprime les propriétés suivantes : attributes, namespaceURI, prefix, et localName.
- Supprime les méthodes suivantes : isSupported(), hasAttributes(), getFeature(), setUserData(), et getUserData().
{{SpecName('DOM3 Core', 'core.html#ID-1950641247', 'Node')}}{{Spec2('DOM3 Core')}}Les méthodes insertBefore(), replaceChild(), removeChild(), etappendChild() renvoient un autre type d'erreur (NOT_SUPPORTED_ERR) si elles sont appelées par {{domxref("Document")}}.
- La méthode normalize()  a été modifiée, ainsi ce mode {{domxref("Text")}} peut aussi être normalisé si la marque {{domxref("DOMConfiguration")}} est définie.
- Ajout des méthodes suivantes : compareDocumentPosition(), isSameNode(), lookupPrefix(), isDefaultNamespace(), lookupNamespaceURI(), isEqualNode(), getFeature(), setUserData(), et getUserData().
- Ajout des propriétés suivantes : baseURI et textContent.
{{SpecName('DOM2 Core', 'core.html#ID-1950641247', 'Node')}}{{Spec2('DOM2 Core')}}La propriété ownerDocumenta été légèrement modifiée pour que  {{domxref("DocumentFragment")}} renvoie également null.
- Ajout des propriétés suivantes : namespaceURI, prefix, et localName.
- Ajout des méthodes suivantes : normalize(), isSupported() et hasAttributes().
{{SpecName('DOM1', 'level-one-core.html#ID-1950641247', 'Node')}}{{Spec2('DOM1')}}Définition initiale
- -

Compatibilité des navigateurs

- -

{{Compat("api.Node")}}

\ No newline at end of file +}; +``` + +#### Exemple d'utilisation + +```js +/* ... an alternative to document.body.innerHTML = "" ... */ +document.body.removeAll(); +``` + +## Spécifications + +| Spécification | Statut | Commentaire | +| ---------------------------------------------------------------------------------------- | -------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| {{SpecName('DOM WHATWG', '#interface-node', 'Node')}} | {{Spec2('DOM WHATWG')}} | Supprime les propriétés suivantes : `attributes`, `namespaceURI`, `prefix`, et `localName`. Supprime les méthodes suivantes : `isSupported()`, `hasAttributes()`, `getFeature()`, `setUserData()`, et `getUserData()`. | +| {{SpecName('DOM3 Core', 'core.html#ID-1950641247', 'Node')}} | {{Spec2('DOM3 Core')}} | Les méthodes `insertBefore()`, `replaceChild()`, `removeChild()`, et`appendChild()` renvoient un autre type d'erreur (`NOT_SUPPORTED_ERR`) si elles sont appelées par {{domxref("Document")}}. La méthode `normalize()`  a été modifiée, ainsi ce mode {{domxref("Text")}} peut aussi être normalisé si la marque {{domxref("DOMConfiguration")}} est définie. Ajout des méthodes suivantes : `compareDocumentPosition()`, `isSameNode()`, `lookupPrefix()`, `isDefaultNamespace()`, `lookupNamespaceURI()`, `isEqualNode()`, `getFeature()`, `setUserData()`, et `getUserData().` Ajout des propriétés suivantes : `baseURI` et `textContent`. | +| {{SpecName('DOM2 Core', 'core.html#ID-1950641247', 'Node')}} | {{Spec2('DOM2 Core')}} | La propriété `ownerDocument`a été légèrement modifiée pour que  {{domxref("DocumentFragment")}} renvoie également `null`. Ajout des propriétés suivantes : `namespaceURI`, `prefix`, et `localName`. Ajout des méthodes suivantes : `normalize()`, `isSupported()` et `hasAttributes()`. | +| {{SpecName('DOM1', 'level-one-core.html#ID-1950641247', 'Node')}} | {{Spec2('DOM1')}} | Définition initiale | + +## Compatibilité des navigateurs + +{{Compat("api.Node")}} diff --git a/files/fr/web/api/node/insertbefore/index.md b/files/fr/web/api/node/insertbefore/index.md index 289539552f..55abf106dd 100644 --- a/files/fr/web/api/node/insertbefore/index.md +++ b/files/fr/web/api/node/insertbefore/index.md @@ -10,47 +10,43 @@ tags: - Noeud translation_of: Web/API/Node/insertBefore --- -

{{APIRef("DOM")}}

+{{APIRef("DOM")}} -

La méthode Node.insertBefore() insère un nœud avant un nœud de référence en tant qu'enfant d'un nœud parent spécifié.

+La méthode **`Node.insertBefore()`** insère un nœud avant un _nœud de référence_ en tant qu'enfant d'un _nœud parent_ spécifié. -

Si le nœud donné existe déjà dans le document, insertBefore() le déplace de sa position actuelle vers la nouvelle position. (C'est-à-dire qu'il sera automatiquement retiré de son parent existant avant d'être ajouté au nouveau parent spécifié).

+Si le nœud donné existe déjà dans le document, `insertBefore()` le déplace de sa position actuelle vers la nouvelle position. (C'est-à-dire qu'il sera automatiquement retiré de son parent existant avant d'être ajouté au nouveau parent spécifié). -

Cela signifie qu'un nœud ne peut pas se trouver simultanément à deux endroits du document.

+Cela signifie qu'un nœud ne peut pas se trouver simultanément à deux endroits du document. -

Syntaxe

+## Syntaxe -
var insertedNode = parentNode.insertBefore(newNode, referenceNode);
-
+ var insertedNode = parentNode.insertBefore(newNode, referenceNode); -
-
insertedNode
-
Le nœud en cours d'insertion (le même que newNode).
-
parentNode
-
Le parent du nœud nouvellement inséré.
-
newNode
-
Le nœud à insérer.
-
referenceNode
-
Le nœud avant lequel newNode est inséré. Si c'est null, alors newNode est inséré à la fin des nœuds enfants de parentNode.
-
+- `insertedNode` + - : Le nœud en cours d'insertion (le même que `newNode`). +- `parentNode` + - : Le parent du nœud nouvellement inséré. +- `newNode` + - : Le nœud à insérer. +- `referenceNode` + - : Le nœud avant lequel `newNode` est inséré. Si c'est `null`, alors `newNode` est inséré à la fin des nœuds enfants de `parentNode`. -
-

Note : referenceNode n'est pas un paramètre facultatif -- vous devez explicitement transmettre un Node ou null. Ne pas le fournir ou transmettre des valeurs invalides provoque des comportements différents selon les différentes versions des navigateurs.

-
+> **Note :** _`referenceNode`_ **n'est pas** un paramètre facultatif -- vous devez explicitement transmettre un `Node` ou `null`. Ne pas le fournir ou transmettre des valeurs invalides provoque des [comportements différents](https://code.google.com/p/chromium/issues/detail?id=419780) selon les différentes versions des navigateurs. -

Valeur de retour

+### Valeur de retour -

Renvoie l'enfant ajouté (sauf si newNode est un {{domxref("DocumentFragment")}}, auquel cas le {{domxref("DocumentFragment")}} vide est renvoyé).

+Renvoie l'enfant ajouté (sauf si `newNode` est un {{domxref("DocumentFragment")}}, auquel cas le {{domxref("DocumentFragment")}} vide est renvoyé). -

Exemples

+## Exemples -

Exemple 1

+### Exemple 1 -
<div id="parentElement">
-  <span id="childElement">foo bar</span>
-</div>
+```html
+
+ foo bar +
-<script> + +``` -

Exemple 2

+### Exemple 2 -
<div id="parentElement">
-  <span id="childElement">foo bar</span>
-</div>
+```html
+
+ foo bar +
-<script> -// Crée un nouvel élément simple de type <span> + +``` -

Il n'existe pas de méthode insertAfter. Il peut être émulé avec une combinaison des méthodes insertBefore et nextSibling.

+Il n'existe pas de méthode `insertAfter`. Il peut être émulé avec une combinaison des méthodes `insertBefore`[ ](/fr/docs/Web/API/Node/insertBefore)et [`nextSibling`](/fr/docs/Web/API/Node/nextSibling). -

Dans l'exemple ci-dessus, sp1 pourrait être inséré après sp2 en utilisant :

+Dans l'exemple ci-dessus, `sp1` pourrait être inséré après `sp2` en utilisant : -
parentDiv.insertBefore(sp1, sp2.nextSibling);
+```js +parentDiv.insertBefore(sp1, sp2.nextSibling); +``` -

Si sp2 n'a pas d'enfant suivant, c'est qu'il est le dernier enfant. Dans ce cas, sp2.nextSibling renverra null et sp1 sera donc inséré à la fin de la liste des nœuds enfants (c'est-à-dire immédiatement après sp2).

+Si `sp2` n'a pas d'enfant suivant, c'est qu'il est le dernier enfant. Dans ce cas, `sp2.nextSibling` renverra `null` et `sp1` sera donc inséré à la fin de la liste des nœuds enfants (c'est-à-dire immédiatement après `sp2`). -

Exemple 3

+### Exemple 3 -

Insérer un élément avant le premier élément enfant en utilisant la propriété firstChild.

+Insérer un élément avant le premier élément enfant en utilisant la propriété [firstChild](/fr/docs/Web/API/Node/firstChild). -
// Obtient l'élément parent
+```js
+// Obtient l'élément parent
   let parentElement = document.getElementById('parentElement')
   // Obtient le premier enfant du parent
   let theFirstChild = parentElement.firstChild
-  
+
   // Crée un nouvel élément
   let newElement = document.createElement("div")
-  
+
   // Insert le nouvel élément avant le premier enfant
   parentElement.insertBefore(newElement, theFirstChild)
-  
- -

Si l'élément n'a pas de premier enfant, alors firstChild est null. L'élément est toujours ajouté au parent après le dernier enfant. Comme l'élément parent n'avait pas de premier enfant, il n'avait pas non plus de dernier enfant. Par conséquent, le nouvel élément est le seul élément, après l'insertion.

- -

Spécifications

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
SpecificationStatusComment
{{SpecName('DOM WHATWG','#dom-node-insertbefore','Node.insertBefore')}}{{Spec2('DOM WHATWG')}}Fixes errors in the insertion algorithm
{{SpecName('DOM4','#dom-node-insertbefore','Node.insertBefore')}}{{Spec2('DOM4')}}Describes the algorithm in more detail
{{SpecName('DOM3 Core','core.html#ID-952280727','Node.insertBefore')}}{{Spec2('DOM3 Core')}}No notable changes
{{SpecName('DOM2 Core','core.html#ID-952280727','Node.insertBefore')}}{{Spec2('DOM2 Core')}}No notable changes
- {{SpecName('DOM1','level-one-core.html#method-insertBefore','Node.insertBefore')}} - {{Spec2('DOM1')}}Introduced
- -

Compatibilité des navigateurs

- -

{{Compat("api.Node.insertBefore")}}

+ +``` + +Si l'élément n'a pas de premier enfant, alors `firstChild` est `null`. L'élément est toujours ajouté au parent après le dernier enfant. Comme l'élément parent n'avait pas de premier enfant, il n'avait pas non plus de dernier enfant. Par conséquent, le nouvel élément est le seul élément, après l'insertion. + +## Spécifications + +| Specification | Status | Comment | +| ------------------------------------------------------------------------------------------------------------ | -------------------------------- | --------------------------------------- | +| {{SpecName('DOM WHATWG','#dom-node-insertbefore','Node.insertBefore')}} | {{Spec2('DOM WHATWG')}} | Fixes errors in the insertion algorithm | +| {{SpecName('DOM4','#dom-node-insertbefore','Node.insertBefore')}} | {{Spec2('DOM4')}} | Describes the algorithm in more detail | +| {{SpecName('DOM3 Core','core.html#ID-952280727','Node.insertBefore')}} | {{Spec2('DOM3 Core')}} | No notable changes | +| {{SpecName('DOM2 Core','core.html#ID-952280727','Node.insertBefore')}} | {{Spec2('DOM2 Core')}} | No notable changes | +| {{SpecName('DOM1','level-one-core.html#method-insertBefore','Node.insertBefore')}} | {{Spec2('DOM1')}} | Introduced | + +## Compatibilité des navigateurs + +{{Compat("api.Node.insertBefore")}} diff --git a/files/fr/web/api/node/isconnected/index.md b/files/fr/web/api/node/isconnected/index.md index 730afa1beb..3ffaaa50de 100644 --- a/files/fr/web/api/node/isconnected/index.md +++ b/files/fr/web/api/node/isconnected/index.md @@ -8,38 +8,38 @@ tags: - Propriétés translation_of: Web/API/Node/isConnected --- -

 

+{{APIRef("DOM")}} -

{{APIRef("DOM")}}

+La propriété en lecture seule **`isConnected`** de l'interface {{domxref("Node")}} renvoie un booléen indiquant si le noeud est connecté (directement ou indirectement) à l'objet contexte, par exemple l'objet {{domxref("Document")}} dans le cas d'un DOM normal  ou l'objet {{domxref("ShadowRoot")}} dans le cas du DOM shadow. -

La propriété en lecture seule isConnected de l'interface {{domxref("Node")}} renvoie un booléen indiquant si le noeud est connecté (directement ou indirectement) à l'objet contexte, par exemple l'objet {{domxref("Document")}} dans le cas d'un DOM normal  ou l'objet {{domxref("ShadowRoot")}} dans le cas du DOM shadow.

+## Syntaxe -

Syntaxe

+ var isItConnected = nodeObjectInstance.isConnected -
var isItConnected = nodeObjectInstance.isConnected
+### Renvoie la valeur -

Renvoie la valeur

+Un {{domxref("Boolean")}} (_booléen_) — `true` (_vrai_) si le noeud est connecté à son objet contextuel pertinent et `false` (_faux_) sinon. -

Un {{domxref("Boolean")}} (booléen) — true (vrai) si le noeud est connecté à son objet contextuel pertinent et false (faux) sinon.

+## Exemples -

Exemples

+Un exemple DOM standard : -

Un exemple DOM standard :

- -
let test = document.createElement('p');
-console.log(test.isConnected); // renvoie false (faux)
+```js
+let test = document.createElement('p');
+console.log(test.isConnected); // renvoie false (faux)
 document.body.appendChild(test);
-console.log(test.isConnected); // renvoie true (vrai)
-
+console.log(test.isConnected); // renvoie true (vrai) +``` -

Un exemple DOM shadow :

+Un exemple DOM shadow : -
// Crée une racine shadow
+```js
+// Crée une racine shadow
 var shadow = this.attachShadow({mode: 'open'});
 
 // Crée du CSS à appliquer au dom shadow
 var style = document.createElement('style');
-console.log(style.isConnected); // renvoie false (faux)
+console.log(style.isConnected); // renvoie false (faux)
 
 style.textContent = '.wrapper {' +
                        'position: relative;' +
@@ -64,33 +64,17 @@ style.textContent = '.wrapper {' +
 // attache l'élément de style créé au dom shadow
 
 shadow.appendChild(style);
-console.log(style.isConnected); // renvoie true (vrai)
- -

 

+console.log(style.isConnected); // renvoie true (vrai) +``` -

Spécifications

- - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('DOM WHATWG','#dom-node-isconnected','isConnected')}}{{Spec2('DOM WHATWG')}}Définition initiale.
-

Compatibilité des navigateurs

+## Spécifications -
-
+| Spécification | Statut | Commentaire | +| ------------------------------------------------------------------------------------ | -------------------------------- | -------------------- | +| {{SpecName('DOM WHATWG','#dom-node-isconnected','isConnected')}} | {{Spec2('DOM WHATWG')}} | Définition initiale. | +## Compatibilité des navigateurs -

{{Compat("api.Node.isConnected")}}

-
-
+{{Compat("api.Node.isConnected")}} diff --git a/files/fr/web/api/node/isdefaultnamespace/index.md b/files/fr/web/api/node/isdefaultnamespace/index.md index 1ea4b789bf..4e1fe3058e 100644 --- a/files/fr/web/api/node/isdefaultnamespace/index.md +++ b/files/fr/web/api/node/isdefaultnamespace/index.md @@ -8,32 +8,27 @@ tags: - Noeuds translation_of: Web/API/Node/isDefaultNamespace --- -
-
{{APIRef("DOM")}}
-
+{{APIRef("DOM")}} -

La méthode Node.isDefaultNamespace() accepte un URI d'espace de nom comme argument et renvoie un {{jsxref("Boolean")}} (booléen) avec une valeur true (vrai) si l'espace de nom est celui par défaut du noeud donné ou false (faux) sinon.

+La méthode **`Node.isDefaultNamespace()`** accepte un URI d'espace de nom comme argument et renvoie un {{jsxref("Boolean")}} (booléen) avec une valeur `true` (_vrai_) si l'espace de nom est celui par défaut du noeud donné ou `false` (_faux_) sinon. -

Syntaxe

+## Syntaxe -
result = node.isDefaultNamespace(namespaceURI)
-
+ result = node.isDefaultNamespace(namespaceURI) -
    -
  • result détient la valeur de retour true (vrai) ou false (faux).
  • -
  • namespaceURI est une string (chaîne de caractères) représentant l'espace de nom par rapport auquel l'élément sera vérifié.
  • -
+- `result` détient la valeur de retour `true` (_vrai_) ou `false` (_faux_). +- `namespaceURI` est une `string` (_chaîne de caractères_) représentant l'espace de nom par rapport auquel l'élément sera vérifié. -

Exemple

+## Exemple -
var XULNS = "http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul";
+```js
+var XULNS = "http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul";
 var el = document.getElementsByTagNameNS(XULNS, 'textbox')[0];
 
-alert(el.isDefaultNamespace(XULNS)); // true
+alert(el.isDefaultNamespace(XULNS)); // true +``` -

Spécification

+## Spécification - +- [DOM Level 3 Core: isDefaultNamespace](http://www.w3.org/TR/DOM-Level-3-Core/core.html#Node3-isDefaultNamespace) +- [Code snippets: isDefaultNamespace](/en-US/docs/Code_snippets/IsDefaultNamespace) diff --git a/files/fr/web/api/node/isequalnode/index.md b/files/fr/web/api/node/isequalnode/index.md index 79bcb16b17..e86aa2118c 100644 --- a/files/fr/web/api/node/isequalnode/index.md +++ b/files/fr/web/api/node/isequalnode/index.md @@ -9,82 +9,68 @@ tags: - Noeuds translation_of: Web/API/Node/isEqualNode --- -
-
{{APIRef("DOM")}}
-
+{{APIRef("DOM")}} -

La méthode Node.isEqualNode() permet de tester l'égalité entre deux éléments du DOM. Deux noeuds sont équivalents s'ils ont le même type, les mêmes caractéristiques de définition (ID, nombre d'enfants et autres), des attributs qui correspondent etc. L'ensemble spécifique de points des données qui doit correspondre varie en fonction des types de nœuds.

+La méthode **`Node.isEqualNode()`** permet de tester l'égalité entre deux éléments du DOM. Deux noeuds sont équivalents s'ils ont le même type, les mêmes caractéristiques de définition (ID, nombre d'enfants et autres), des attributs qui correspondent etc. L'ensemble spécifique de points des données qui doit correspondre varie en fonction des types de nœuds. -

Syntaxe

+## Syntaxe -
var isEqualNode = node.isEqualNode(otherNode);
-
+ var isEqualNode = node.isEqualNode(otherNode); -
    -
  • otherNode : Le noeud à comparer.
  • -
+- `otherNode` : Le noeud à comparer. -

Exemple

+## Exemple -

Dans cet exemple, nous créons trois blocs {{HTMLElement("div")}}. Le premier et le troisième ont les mêmes contenus et attributs, alors que le second est différent. Alors, nous éxécutons du JavaScript pour comparer les noeuds en utilisant isEqualNode() et sortons les résultats.

+Dans cet exemple, nous créons trois blocs {{HTMLElement("div")}}. Le premier et le troisième ont les mêmes contenus et attributs, alors que le second est différent. Alors, nous éxécutons du JavaScript pour comparer les noeuds en utilisant `isEqualNode()` et sortons les résultats. -

HTML

+### HTML -
<div>This is the first element.</div>
-<div>This is the second element.</div>
-<div>This is the first element.</div>
+```html
+
This is the first element.
+
This is the second element.
+
This is the first element.
-<p id="output"></p>
+

+``` -

CSS

+### CSS -
#output {
+```css
+#output {
   width: 440px;
   border: 2px solid black;
   border-radius: 5px;
   padding: 10px;
   margin-top: 20px;
   display: block;
-}
+} +``` -

JavaScript

+### JavaScript -
let output = document.getElementById("output");
+```js
+let output = document.getElementById("output");
 let divList  = document.getElementsByTagName("div");
 
-output.innerHTML += "div 0 equals div 0: " + divList[0].isEqualNode(divList[0]) + "<br/>";
-output.innerHTML += "div 0 equals div 1: " + divList[0].isEqualNode(divList[1]) + "<br/>";
-output.innerHTML += "div 0 equals div 2: " + divList[0].isEqualNode(divList[2]) + "<br/>";
+output.innerHTML += "div 0 equals div 0: " + divList[0].isEqualNode(divList[0]) + "
"; +output.innerHTML += "div 0 equals div 1: " + divList[0].isEqualNode(divList[1]) + "
"; +output.innerHTML += "div 0 equals div 2: " + divList[0].isEqualNode(divList[2]) + "
"; +``` -

Résultats

+### Résultats -

{{ EmbedLiveSample('Example', 480) }}

+{{ EmbedLiveSample('Example', 480) }} -

Spécifications

+## Spécifications - - - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('DOM WHATWG', '#dom-node-isequalnode', 'Node.isEqualNode')}}{{Spec2('DOM WHATWG')}} 
+| Spécification | Statut | Commentaire | +| ------------------------------------------------------------------------------------------------ | -------------------------------- | ----------- | +| {{SpecName('DOM WHATWG', '#dom-node-isequalnode', 'Node.isEqualNode')}} | {{Spec2('DOM WHATWG')}} |   | -

Compatibilité des navigateurs

+## Compatibilité des navigateurs -

{{Compat("api.Node.isEqualNode")}}

+{{Compat("api.Node.isEqualNode")}} -

Voir aussi

+## Voir aussi -
    -
  • {{domxref("Node.isSameNode()")}}
  • -
+- {{domxref("Node.isSameNode()")}} diff --git a/files/fr/web/api/node/issamenode/index.md b/files/fr/web/api/node/issamenode/index.md index cab5401b56..682d50b9e7 100644 --- a/files/fr/web/api/node/issamenode/index.md +++ b/files/fr/web/api/node/issamenode/index.md @@ -8,86 +8,69 @@ tags: - Noeuds translation_of: Web/API/Node/isSameNode --- -
{{APIRef("DOM")}}
+{{APIRef("DOM")}} -

La méthode Node.isSameNode() teste si deux noeuds sont identiques, c'est-à-dire, s'ils font référence au même objet.

+La méthode **`Node.isSameNode()`** teste si deux noeuds sont identiques, c'est-à-dire, s'ils font référence au même objet. -

Syntaxe

+## Syntaxe -
var isSameNode = node.isSameNode(other);
-
+ var isSameNode = node.isSameNode(other); -

Paramètres

+### Paramètres -
    -
  • other Le {{domxref("Node")}} à tester.
  • -
+- `other` Le {{domxref("Node")}} à tester. -

Exemple

+## Exemple -

Dans cet exemple, nous créons 3 blocs {{HTMLElement("div")}}. Le premier et le troisième ont les mêmes contenus et attributs, alors que le second est différent. Ensuite, nous exécutons du JavaScript pour comparer les nœuds en utilisant isSameNode() et sortons les résultats.

+Dans cet exemple, nous créons 3 blocs {{HTMLElement("div")}}. Le premier et le troisième ont les mêmes contenus et attributs, alors que le second est différent. Ensuite, nous exécutons du JavaScript pour comparer les nœuds en utilisant `isSameNode()` et sortons les résultats. -

HTML

+### HTML -
<div>This is the first element.</div>
-<div>This is the second element.</div>
-<div>This is the first element.</div>
+```html
+
This is the first element.
+
This is the second element.
+
This is the first element.
-<p id="output"></p>
+

+``` - +} +``` -

JavaScript

+### JavaScript -
let output = document.getElementById("output");
+```js
+let output = document.getElementById("output");
 let divList  = document.getElementsByTagName("div");
 
-output.innerHTML += "div 0 same as div 0: " + divList[0].isSameNode(divList[0]) + "<br/>";
-output.innerHTML += "div 0 same as div 1: " + divList[0].isSameNode(divList[1]) + "<br/>";
-output.innerHTML += "div 0 same as div 2: " + divList[0].isSameNode(divList[2]) + "<br/>";
-
- -

Résultats

- -

{{ EmbedLiveSample('Example', 480) }}

- -

Spécifications

- - - - - - - - - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('DOM WHATWG', '#interface-node', 'Node')}}{{Spec2('DOM WHATWG')}}Pas de changement (a été longtemps retiré).
{{SpecName('DOM3 Core', 'core.html#Node3-isSameNode', 'Node.isSameNode()')}}{{Spec2('DOM3 Core')}}Définition initiale
- -

Compatibilité des navigateurs

- -

{{Compat("api.Node.isSameNode")}}

- -

Voir aussi

- -
    -
  • {{domxref("Node.isEqualNode()")}}
  • -
+output.innerHTML += "div 0 same as div 0: " + divList[0].isSameNode(divList[0]) + "
"; +output.innerHTML += "div 0 same as div 1: " + divList[0].isSameNode(divList[1]) + "
"; +output.innerHTML += "div 0 same as div 2: " + divList[0].isSameNode(divList[2]) + "
"; +``` + +### Résultats + +{{ EmbedLiveSample('Example', 480) }} + +## Spécifications + +| Spécification | Statut | Commentaire | +| ---------------------------------------------------------------------------------------------------- | -------------------------------- | ------------------------------------------- | +| {{SpecName('DOM WHATWG', '#interface-node', 'Node')}} | {{Spec2('DOM WHATWG')}} | Pas de changement (a été longtemps retiré). | +| {{SpecName('DOM3 Core', 'core.html#Node3-isSameNode', 'Node.isSameNode()')}} | {{Spec2('DOM3 Core')}} | Définition initiale | + +## Compatibilité des navigateurs + +{{Compat("api.Node.isSameNode")}} + +## Voir aussi + +- {{domxref("Node.isEqualNode()")}} diff --git a/files/fr/web/api/node/issupported/index.md b/files/fr/web/api/node/issupported/index.md index 3c241d4656..d59dab5a7b 100644 --- a/files/fr/web/api/node/issupported/index.md +++ b/files/fr/web/api/node/issupported/index.md @@ -8,71 +8,48 @@ tags: - Noeuds translation_of: Web/API/Node/isSupported --- -

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

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

La méthode Node.isSupported() renvoie une marque  {{domxref("Boolean","booléenne")}} contenant le résultat du test par lequel est vérifié si une implémentation DOM prend en charge une fonctionnalité spécifique et si celle-ci est supportée par un noeud spécifique.

+La méthode **`Node.isSupported()`** renvoie une marque  {{domxref("Boolean","booléenne")}} contenant le résultat du test par lequel est vérifié si une implémentation DOM prend en charge une fonctionnalité spécifique et si celle-ci est supportée par un noeud spécifique. -

Syntaxe

+### Syntaxe -
boolValue = element.isSupported(feature, version)
+ boolValue = element.isSupported(feature, version) -

Paramètres

+### Paramètres -
-
feature
-
est une  {{domxref("DOMString")}} (chaîne de caractères) contenant le nom de la fonctionnalité à tester. C'est le même nom qui peut être passé à la méthode hasFeature de DOMImplementation. Les valeurs possibles définies dans la spécification DOM core sont listées dans la section Conformance de DOM Level 2.
-
version
-
est une  {{domxref("DOMString")}} (chaîne de caractères) contenant le numéro de version de la fonctionnalité à tester. En DOM Level 2, première version, il s'agit de la chaîne « 2.0 ». Si la version n'est pas spécifiée, la gestion de n'importe quelle version de la fonctionnalité suffira pour que soit renvoyée la valeur true.
-
+- `feature` + - : est une  {{domxref("DOMString")}} (_chaîne de caractères_) contenant le nom de la fonctionnalité à tester. C'est le même nom qui peut être passé à la méthode `hasFeature` de [DOMImplementation](/fr/docs/Web/API/Document/implementation). Les valeurs possibles définies dans la spécification DOM core sont listées dans la section [Conformance](http://www.w3.org/TR/DOM-Level-2-Core/introduction.html#ID-Conformance) de DOM Level 2. +- `version` + - : est une  {{domxref("DOMString")}} (_chaîne de caractères_) contenant le numéro de version de la fonctionnalité à tester. En DOM Level 2, première version, il s'agit de la chaîne « `2.0` ». Si la version n'est pas spécifiée, la gestion de n'importe quelle version de la fonctionnalité suffira pour que soit renvoyée la valeur `true`. -

Exemple

+## Exemple -
<div id="doc">
-</div>
+```html
+
+
-<script> + +``` + +## Spécifications + + + +| Spécification | Statut | Commentaire | +| -------------------------------------------------------------------------------------------------------------------- | -------------------------------- | ------------------------------------------------------ | +| {{SpecName('DOM WHATWG', '#interface-node', 'Node')}} | {{Spec2('DOM WHATWG')}} | Supprimée de la spécification | +| {{SpecName('DOM3 Core', 'core.html#Level-2-Core-Node-supports', 'Node.isSupported()')}} | {{Spec2('DOM3 Core')}} | Pas de changement de {{SpecName('DOM2 Core')}}. | +| {{SpecName('DOM2 Core', 'core.html#Level-2-Core-Node-supports', 'Node.isSupported()')}} | {{Spec2('DOM2 Core')}} | Définition initiale. | + +## Compatibilité des navigateurs + +{{Compat("api.Node.isSupported")}} + +## Voir aussi + +- L'interface {{domxref("Node")}} à laquelle elle appartient. diff --git a/files/fr/web/api/node/lastchild/index.md b/files/fr/web/api/node/lastchild/index.md index 37963f8473..a44709a33d 100644 --- a/files/fr/web/api/node/lastchild/index.md +++ b/files/fr/web/api/node/lastchild/index.md @@ -9,58 +9,34 @@ tags: - Propriétés translation_of: Web/API/Node/lastChild --- -

{{APIRef("DOM")}}

+{{APIRef("DOM")}} -

La propriété en lecture seule Node.lastChild renvoie le dernier enfant du noeud. Si son parent est un élément, l'enfant est généralement un noeud élément, texte ou commentaire. Elle renvoie null s'il n'y a aucun enfant.

+La propriété en lecture seule** \*\***`Node.lastChild`\*\* renvoie le dernier enfant du noeud. Si son parent est un élément, l'enfant est généralement un noeud élément, texte ou commentaire. Elle renvoie `null` s'il n'y a aucun enfant. -

Syntaxe

+## Syntaxe -
var childNode = node.lastChild;
-
+ var childNode = node.lastChild; -

 

-

Exemple

-

 

+## Exemple -
var tr = document.getElementById("row1");
-var corner_td = tr.lastChild;
-

Spécification

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('DOM WHATWG', '#dom-node-lastchild', 'Node.lastChild')}}{{Spec2('DOM WHATWG')}}Pas de changement
{{SpecName('DOM3 Core', 'core.html#ID-61AD09FB', 'Node.lastChild')}}{{Spec2('DOM3 Core')}}Pas de changement
{{SpecName('DOM2 Core', 'core.html#ID-61AD09FB', 'Node.lastChild')}}{{Spec2('DOM2 Core')}}Pas de changement
{{SpecName('DOM1', 'level-one-core.html#ID-61AD09FB', 'Node.lastChild')}}{{Spec2('DOM1')}}Définition initiale
+```js +var tr = document.getElementById("row1"); +var corner_td = tr.lastChild; +``` -

Compatibilité des navigateurs

+## Spécification -

{{Compat("api.Node.lastChild")}}

\ No newline at end of file +| Spécification | Statut | Commentaire | +| ------------------------------------------------------------------------------------------------ | -------------------------------- | ------------------- | +| {{SpecName('DOM WHATWG', '#dom-node-lastchild', 'Node.lastChild')}} | {{Spec2('DOM WHATWG')}} | Pas de changement | +| {{SpecName('DOM3 Core', 'core.html#ID-61AD09FB', 'Node.lastChild')}} | {{Spec2('DOM3 Core')}} | Pas de changement | +| {{SpecName('DOM2 Core', 'core.html#ID-61AD09FB', 'Node.lastChild')}} | {{Spec2('DOM2 Core')}} | Pas de changement | +| {{SpecName('DOM1', 'level-one-core.html#ID-61AD09FB', 'Node.lastChild')}} | {{Spec2('DOM1')}} | Définition initiale | + +## Compatibilité des navigateurs + +{{Compat("api.Node.lastChild")}} diff --git a/files/fr/web/api/node/lookupnamespaceuri/index.md b/files/fr/web/api/node/lookupnamespaceuri/index.md index 1c88e6b8a2..d97ba7c2ea 100644 --- a/files/fr/web/api/node/lookupnamespaceuri/index.md +++ b/files/fr/web/api/node/lookupnamespaceuri/index.md @@ -8,16 +8,12 @@ tags: - Noeuds translation_of: Web/API/Node/lookupNamespaceURI --- -
{{APIRef("DOM")}}
+{{APIRef("DOM")}} -

La méthode Node.lookupNamespaceURI() accepte un préfixe et renvoie l'URI de l'espace de nom associé avec lui sur le noeud donné s'il le trouve (et null sinon). La fourniture de null pour le préfixe renverra l'espace de nom par défaut.

+La méthode **`Node.lookupNamespaceURI()`** accepte un préfixe et renvoie l'URI de l'espace de nom associé avec lui sur le noeud donné s'il le trouve (et `null` sinon). La fourniture de `null` pour le préfixe renverra l'espace de nom par défaut. -

Du fait du bug 312019, cette méthode ne fonctionne pas avec les espaces de noms attribués dynamiquement (c'est-à-dire ceux qui sont définis par Node.prefix).

+Du fait du [bug 312019](https://bugzilla.mozilla.org/show_bug.cgi?id=312019), cette méthode ne fonctionne pas avec les espaces de noms attribués dynamiquement (c'est-à-dire ceux qui sont définis par [Node.prefix](/en/DOM/Node.prefix)). -

Voir aussi

+## Voir aussi - - -

 

+- [http://www.w3.org/TR/DOM-Level-3-Cor...upNamespaceURI](http://www.w3.org/TR/DOM-Level-3-Core/core.html#Node3-lookupNamespaceURI) diff --git a/files/fr/web/api/node/lookupprefix/index.md b/files/fr/web/api/node/lookupprefix/index.md index 17cc48c622..a7a28baee5 100644 --- a/files/fr/web/api/node/lookupprefix/index.md +++ b/files/fr/web/api/node/lookupprefix/index.md @@ -10,14 +10,12 @@ tags: - URI translation_of: Web/API/Node/lookupPrefix --- -
{{APIRef("DOM")}}
+{{APIRef("DOM")}} -

La méthode Node.lookupPrefix() renvoie une {{domxref("DOMString")}} (chaîne de caractères) contenant le préfixe d'un URI d'un espace de nom donné, s'il est présent, et null sinon. Quand plusieurs préfixes sont possibles, le résultat dépend de l'implémentation.

+La méthode **`Node.lookupPrefix()`** renvoie une {{domxref("DOMString")}} (_chaîne de caractères_) contenant le préfixe d'un URI d'un espace de nom donné, s'il est présent, et `null` sinon. Quand plusieurs préfixes sont possibles, le résultat dépend de l'implémentation. -

En raison du bug 312019, cette méthode ne fonctionne plus avec les espaces de nom définis dynamiquement, c'est-à-dire ceux qui sont fixés avec la propriété {{domxref("Node.prefix")}}.

+En raison du [bug 312019](https://bugzilla.mozilla.org/show_bug.cgi?id=312019), cette méthode ne fonctionne plus avec les espaces de nom définis dynamiquement, c'est-à-dire ceux qui sont fixés avec la propriété {{domxref("Node.prefix")}}. -

Voir aussi

+## Voir aussi - +- [http://www.w3.org/TR/DOM-Level-3-Cor...amespacePrefix](http://www.w3.org/TR/DOM-Level-3-Core/core.html#Node3-lookupNamespacePrefix) diff --git a/files/fr/web/api/node/nextsibling/index.md b/files/fr/web/api/node/nextsibling/index.md index 2a971a3067..19e0ddb762 100644 --- a/files/fr/web/api/node/nextsibling/index.md +++ b/files/fr/web/api/node/nextsibling/index.md @@ -8,34 +8,34 @@ tags: - Propriétés translation_of: Web/API/Node/nextSibling --- -

{{APIRef("DOM")}}

+{{APIRef("DOM")}} -

La propriété en lecture seule  Node.nextSibling renvoie le nœud (node) suivant immédiatement le nœud spécifié dans la liste des enfants ( {{domxref("Node.childNodes","childNodes")}}) de son nœud parent, ou null si le nœud spécifié est le dernier dans cette liste.

+La propriété en lecture seule  **`Node.nextSibling`** renvoie le nœud (`node`) suivant immédiatement le nœud spécifié dans la liste des enfants ( {{domxref("Node.childNodes","childNodes")}}) de son nœud parent, ou `null` si le nœud spécifié est le dernier dans cette liste. -

Syntaxe

+## Syntaxe -
nextNode = node.nextSibling
-
+ nextNode = node.nextSibling -

Notes

+## Notes -

Les navigateurs basés sur Gecko insèrent des nœuds texte dans un document pour représenter des espaces - vides dans le balisage source. Par conséquent, un nœud obtenu par exemple via Node.firstChild ou - Node.previousSibling peut faire référence à un nœud texte contenant des espaces plutôt qu'au véritable élément - que l'auteur comptait obtenir.

+Les navigateurs basés sur Gecko insèrent des nœuds texte dans un document pour représenter des espaces +vides dans le balisage source. Par conséquent, un nœud obtenu par exemple via [`Node.firstChild`](/fr/docs/Web/API/Node/firstChild) ou +[`Node.previousSibling`](/fr/docs/Web/API/Node/previousSibling "{{APIRef("DOM")}}") peut faire référence à un nœud texte contenant des espaces plutôt qu'au véritable élément +que l'auteur comptait obtenir. -

Consultez Gestion des espaces dans le DOM - et Why are some Text nodes empty? - dans la FAQ DOM 3 du W3C pour plus d'informations.

+Consultez [Gestion des espaces dans le DOM](/fr/docs/Gestion_des_espaces_dans_le_DOM) +et [_Why are some Text nodes empty?_ +dans la FAQ DOM 3 du W3C](http://www.w3.org/DOM/faq.html#emptytext) pour plus d'informations. -

{{domxref("Element.nextElementSibling")}} peut être utilisé pour obtenir l'élément suivant en ignorant les noeuds d'espace.

+{{domxref("Element.nextElementSibling")}} peut être utilisé pour obtenir l'élément suivant en ignorant les noeuds d'espace. -

Exemple

+## Exemple -
<div id="div-01">Here is div-01</div>
-<div id="div-02">Here is div-02</div>
+```html
+
Here is div-01
+
Here is div-02
-<script type="text/javascript"> + /************************************************** Ce qui suit est écrit sur la console pendant le chargement: @@ -59,25 +59,22 @@ while (el) { 3. #text 4. SCRIPT -**************************************************/
+**************************************************/ +``` -

Dans cet exemple, on peut voir que des nœuds #text sont insérés dans le DOM là où des espaces se trouvent dans le code source entre les balises (c'est-à-dire après la balise de fermeture d'un élément et avant la balise d'ouverture du suivant). Aucun espace n'est créé entre les éléments insérés par l'instruction document.write .

+Dans cet exemple, on peut voir que des nœuds `#text` sont insérés dans le DOM là où des espaces se trouvent dans le code source entre les balises (c'est-à-dire après la balise de fermeture d'un élément et avant la balise d'ouverture du suivant). Aucun espace n'est créé entre les éléments insérés par l'instruction `document.write` . -

L'inclusion possible de nœuds textes dans le DOM doit être prise en compte pour le parcours du DOM à l'aide de nextSibling. Consultez les ressources dans la section Notes .

+L'inclusion possible de nœuds textes dans le DOM doit être prise en compte pour le parcours du DOM à l'aide de `nextSibling`. Consultez les ressources dans la section Notes . -

Spécification

+## Spécification - +- [DOM Level 1 Core: nextSibling](http://www.w3.org/TR/REC-DOM-Level-1/level-one-core.html#attribute-nextSibling) — [traduction](http://xmlfr.org/w3c/TR/REC-DOM-Level-1/level-one-core.html#attribute-nextSibling) (non normative) +- [DOM Level 2 Core: nextSibling](http://www.w3.org/TR/DOM-Level-2-Core/core.html#ID-6AC54C2F) — [traduction](http://www.yoyodesign.org/doc/w3c/dom2/core/core.html#ID-6AC54C2F) (non normative) -

Compatibilité des navigateurs

+## Compatibilité des navigateurs +{{Compat("api.Node.nextSibling")}} +## Voir aussi -

{{Compat("api.Node.nextSibling")}}

- -

Voir aussi

- -

{{domxref("Element.nextElementSibling")}}

+{{domxref("Element.nextElementSibling")}} diff --git a/files/fr/web/api/node/nodename/index.md b/files/fr/web/api/node/nodename/index.md index 11c471fff1..ef15c51fc1 100644 --- a/files/fr/web/api/node/nodename/index.md +++ b/files/fr/web/api/node/nodename/index.md @@ -9,103 +9,54 @@ tags: - Propriété translation_of: Web/API/Node/nodeName --- -

{{APIRef("DOM")}}

- -

La propriété en lecture seule Node.nodeName renvoie le nom du nœud courant dans une chaîne.

- -

Les valeurs retournées pour les différents types de noeuds sont :

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
InterfaceValeur nodeName
{{domxref("Attr")}}La valeur de {{domxref("Attr.name")}}
{{domxref("CDATASection")}}"#cdata-section"
{{domxref("Comment")}}"#comment"
{{domxref("Document")}}"#document"
{{domxref("DocumentFragment")}}"#document-fragment"
{{domxref("DocumentType")}}La valeur de {{domxref("DocumentType.name")}}
{{domxref("Element")}}La valeur de {{domxref("Element.tagName")}}
{{domxref("Entity")}}Le nom de l'entité
{{domxref("EntityReference")}}Le nom de la référence d'entité
{{domxref("Notation")}}Le nom de notation
{{domxref("ProcessingInstruction")}}La valeur de {{domxref("ProcessingInstruction.target")}}
{{domxref("Text")}}"#text"
- -

Syntaxe

- -
var str = node.nodeName;
-
- -

Exemple

- -

Avec le balisage suivant :

- -
<div id="d1">hello world</div>
-<input type="text" id="t"/>
-
- -

et le script suivant :

- -
var div1 = document.getElementById("d1");
-var text_field = document.getElementById("t");
-text_field.value = div1.nodeName;
-
- -

En XHTML (ou tout autre format XML), la valeur de text_field sera « div ». Cependant, en HTML, la valeur de text_field sera « DIV », parce que nodeName et tagName renvoient en casse majuscule sur les éléments HTML dans les DOM marqués comme des documents HTML. En lire plus détails sur la sensibilité à la casse de nodeName dans différents navigateurs (en).

- -

Notez que la propriété tagName aurait pu être uilisée à la place, puisque nodeName a la même valeur que tagName pour un élément. Souvenez vous cependant que nodeName renverra #text pour les nœuds texte tandis que tagName renverra undefined.

- -

Spécification

- - - -

Compatibilité des navigateurs

- - - -

{{Compat("api.Node.nodeName")}}

+{{APIRef("DOM")}} + +La propriété en lecture seule **`Node.nodeName`** renvoie le nom du nœud courant dans une chaîne. + +Les valeurs retournées pour les différents types de noeuds sont : + +| Interface | Valeur nodeName | +| ------------------------------------------------ | --------------------------------------------------------------------- | +| {{domxref("Attr")}} | La valeur de {{domxref("Attr.name")}} | +| {{domxref("CDATASection")}} | `"#cdata-section"` | +| {{domxref("Comment")}} | `"#comment"` | +| {{domxref("Document")}} | `"#document"` | +| {{domxref("DocumentFragment")}} | `"#document-fragment"` | +| {{domxref("DocumentType")}} | La valeur de {{domxref("DocumentType.name")}} | +| {{domxref("Element")}} | La valeur de {{domxref("Element.tagName")}} | +| {{domxref("Entity")}} | Le nom de l'entité | +| {{domxref("EntityReference")}} | Le nom de la référence d'entité | +| {{domxref("Notation")}} | Le nom de notation | +| {{domxref("ProcessingInstruction")}} | La valeur de {{domxref("ProcessingInstruction.target")}} | +| {{domxref("Text")}} | `"#text"` | + +## Syntaxe + + var str = node.nodeName; + +## Exemple + +Avec le balisage suivant : + +
hello world
+ + +et le script suivant : + + var div1 = document.getElementById("d1"); + var text_field = document.getElementById("t"); + text_field.value = div1.nodeName; + +En XHTML (ou tout autre format XML), la valeur de `text_field` sera « div ». Cependant, en HTML, la valeur de `text_field` sera « DIV », parce que `nodeName` et `tagName` renvoient en casse majuscule sur les éléments HTML dans les DOM marqués comme des documents HTML. En lire plus [détails sur la sensibilité à la casse de nodeName dans différents navigateurs](http://ejohn.org/blog/nodename-case-sensitivity/) (en). + +Notez que la propriété [`tagName`](fr/DOM/element.tagName) aurait pu être uilisée à la place, puisque `nodeName` a la même valeur que `tagName` pour un élément. Souvenez vous cependant que `nodeName` renverra `#text` pour les nœuds texte tandis que `tagName` renverra `undefined`. + +## Spécification + +- [DOM Level 2 Core: Node.nodeName](http://www.w3.org/TR/DOM-Level-2-Core/core.html#ID-F68D095) — [traduction](http://www.yoyodesign.org/doc/w3c/dom2-core/core.html#ID-F68D095) (non normative) +- [DOM Level 3 Core: Node.nodeName](http://www.w3.org/TR/DOM-Level-3-Core/core.html#ID-F68D095) +- [HTML 5: APIs in HTML documents](http://www.whatwg.org/specs/web-apps/current-work/multipage/dom.html#apis-in-html-documents) + +## Compatibilité des navigateurs + +{{Compat("api.Node.nodeName")}} diff --git a/files/fr/web/api/node/nodetype/index.md b/files/fr/web/api/node/nodetype/index.md index 2f6cd30d79..082ae1bd03 100644 --- a/files/fr/web/api/node/nodetype/index.md +++ b/files/fr/web/api/node/nodetype/index.md @@ -9,172 +9,125 @@ tags: - Types translation_of: Web/API/Node/nodeType --- -
{{APIRef("DOM")}}
+{{APIRef("DOM")}}La propriété en lecture seule **`Node.nodeType`** représente le type du noeud. -
La propriété en lecture seule Node.nodeType représente le type du noeud.
+## Description -

Description

+La propriété **`nodeType`** peut être utilisée pour distinguer les uns des autres les différents genres de noeuds tels que {{domxref("Element")}}, {{domxref("Text")}} et {{domxref("Comment")}} . -

La propriété nodeType peut être utilisée pour distinguer les uns des autres les différents genres de noeuds tels que {{domxref("Element")}}, {{domxref("Text")}} et {{domxref("Comment")}} .

+## Syntaxe -

Syntaxe

+ Type = node .nodeType -
Type = node .nodeType
-
+Renvoie un entier (_integer_) qui spécifie le type du noeud ; les valeurs possibles sont listées dans {{anch("Constantes")}}. -

Renvoie un entier (integer) qui spécifie le type du noeud ; les valeurs possibles sont listées dans {{anch("Constantes")}}.

+## Constantes -

Constantes

+### Constantes de type nœud -

Constantes de type nœud

+| Constante | Valeur | Description | +| ---------------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------ | +| `Node.ELEMENT_NODE` | `1` | Un noeud {{domxref("Element")}}  tel que {{HTMLElement("p")}} ou {{HTMLElement("div")}}`.` | +| `Node.TEXT_NODE` | `3` | Le {{domxref("Text")}} actuel de l'{{domxref("Element")}} ou {{domxref("Attr")}}. | +| `Node.PROCESSING_INSTRUCTION_NODE` | `7` | Une {{domxref("ProcessingInstruction")}} d'un document XML tel que la déclaration ``. | +| `Node.COMMENT_NODE` | `8` | Un noeud {{domxref("Comment")}}. | +| `Node.DOCUMENT_NODE` | `9` | Un noeud {{domxref("Document")}}. | +| `Node.DOCUMENT_TYPE_NODE` | `10` | Un noeud {{domxref("DocumentType")}} c'est-à-dire `` pour des documents HTML5. | +| `Node.DOCUMENT_FRAGMENT_NODE` | `11` | Un noeud {{domxref("DocumentFragment")}}. | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
ConstanteValeurDescription
Node.ELEMENT_NODE1Un noeud {{domxref("Element")}}  tel que {{HTMLElement("p")}} ou {{HTMLElement("div")}}.
Node.TEXT_NODE3Le {{domxref("Text")}} actuel de l'{{domxref("Element")}} ou {{domxref("Attr")}}.
Node.PROCESSING_INSTRUCTION_NODE7Une {{domxref("ProcessingInstruction")}} d'un document XML tel que la déclaration <?xml-stylesheet ... ?>.
Node.COMMENT_NODE8Un noeud {{domxref("Comment")}}.
Node.DOCUMENT_NODE9Un noeud {{domxref("Document")}}.
Node.DOCUMENT_TYPE_NODE10Un noeud {{domxref("DocumentType")}} c'est-à-dire <!DOCTYPE html> pour des documents HTML5.
Node.DOCUMENT_FRAGMENT_NODE11Un noeud {{domxref("DocumentFragment")}}.
+### Constantes de type noeud dépréciées {{deprecated_inline()}} -

Constantes de type noeud dépréciées {{deprecated_inline()}}

- -

Les constantes suivantes ont été dépréciées et ne doivent plus être utilisées.

+Les constantes suivantes ont été dépréciées et ne doivent plus être utilisées. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
ConstanteValeurDescription
Node.ATTRIBUTE_NODE2Un {{domxref("Attr", "Attribut")}} d'un {{domxref("Element")}}. Les attributs d'élément n'implémentent plus l'interface {{domxref("Node")}} dans la spécification {{SpecName("DOM4")}}.
Node.CDATA_SECTION_NODE4Une {{domxref("CDATASection")}}. Supprimée dans la spécification {{SpecName("DOM4")}}.
Node.ENTITY_REFERENCE_NODE5Un noeud référence d'entité XML. Supprimé dans la spécification {{SpecName("DOM4")}}.
Node.ENTITY_NODE6Un noeud <!ENTITY ...> XML. Supprimé dans la spécificatioin {{SpecName("DOM4")}}.
Node.NOTATION_NODE12Un noeud <!NOTATION ...> XML. Supprimé dans la spécification {{SpecName("DOM4")}}.
ConstanteValeurDescription
Node.ATTRIBUTE_NODE2 + Un {{domxref("Attr", "Attribut")}} d'un + {{domxref("Element")}}. Les attributs d'élément n'implémentent + plus l'interface {{domxref("Node")}} dans la spécification + {{SpecName("DOM4")}}. +
Node.CDATA_SECTION_NODE4 + Une {{domxref("CDATASection")}}. Supprimée dans la + spécification {{SpecName("DOM4")}}. +
Node.ENTITY_REFERENCE_NODE5 + Un noeud référence d'entité XML. Supprimé dans la spécification + {{SpecName("DOM4")}}. +
Node.ENTITY_NODE6 + Un noeud <!ENTITY ...> XML. Supprimé dans la + spécificatioin {{SpecName("DOM4")}}. +
Node.NOTATION_NODE12 + Un noeud <!NOTATION ...> XML. Supprimé dans la + spécification {{SpecName("DOM4")}}. +
-

Exemples

+## Exemples -

Différents types de noeuds

+### Différents types de noeuds -
document.nodeType === Node.DOCUMENT_NODE; // true (vrai)
-document.doctype.nodeType === Node.DOCUMENT_TYPE_NODE; // true  (vrai)
+```js
+document.nodeType === Node.DOCUMENT_NODE; // true (vrai)
+document.doctype.nodeType === Node.DOCUMENT_TYPE_NODE; // true  (vrai)
 
 var fragment = document.createDocumentFragment();
-fragment.nodeType === Node.DOCUMENT_FRAGMENT_NODE; // true  (vrai)
+fragment.nodeType === Node.DOCUMENT_FRAGMENT_NODE; // true  (vrai)
 
-var p = document.createElement("p");
-p.textContent = "Once upon a time...";
+var p = document.createElement("p");
+p.textContent = "Once upon a time...";
 
-p.nodeType === Node.ELEMENT_NODE; // true  (vrai)
-p.firstChild.nodeType === Node.TEXT_NODE; // true  (vrai)
-
+p.nodeType === Node.ELEMENT_NODE; // true (vrai) +p.firstChild.nodeType === Node.TEXT_NODE; // true (vrai) +``` -

Commentaires

+### Commentaires -

Cet exemple vérifie si le premier noeud dans l'élément du document est un noeud commentaire et si ce n'est pas le cas, affiche un message.

+Cet exemple vérifie si le premier noeud dans l'élément du document est un noeud commentaire et si ce n'est pas le cas, affiche un message. -
var node = document.documentElement.firstChild;
+```js
+var node = document.documentElement.firstChild;
 if (node.nodeType != Node.COMMENT_NODE)
-  console.log("You should comment your code well!");
- -

Spécifications

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('DOM WHATWG', '#dom-node-nodetype', 'Node.nodeType')}}{{Spec2('DOM WHATWG')}}Sont dépréciés les types ATTRIBUTE_NODE, CDATA_SECTION_NODE, ENTITY_REFERENCE_NODE et NOTATION_NODE.
{{SpecName('DOM3 Core', 'core.html#ID-1950641247', 'Node.nodeType')}}{{Spec2('DOM3 Core')}}Pas de changement.
{{SpecName('DOM2 Core', 'core.html#ID-111237558', 'Node.nodeType')}}{{Spec2('DOM2 Core')}}Pas de changement.
{{SpecName('DOM1', 'level-one-core.html#ID-111237558', 'Node.nodeType')}}{{Spec2('DOM1')}}Définition initiale.
+ console.log("You should comment your code well!"); +``` -

Compatibilité des navigateurs

+## Spécifications +| Spécification | Statut | Commentaire | +| ------------------------------------------------------------------------------------------------ | -------------------------------- | ------------------------------------------------------------------------------------------------------ | +| {{SpecName('DOM WHATWG', '#dom-node-nodetype', 'Node.nodeType')}} | {{Spec2('DOM WHATWG')}} | Sont dépréciés les types `ATTRIBUTE_NODE, CDATA_SECTION_NODE, ENTITY_REFERENCE_NODE et NOTATION_NODE`. | +| {{SpecName('DOM3 Core', 'core.html#ID-1950641247', 'Node.nodeType')}} | {{Spec2('DOM3 Core')}} | Pas de changement. | +| {{SpecName('DOM2 Core', 'core.html#ID-111237558', 'Node.nodeType')}} | {{Spec2('DOM2 Core')}} | Pas de changement. | +| {{SpecName('DOM1', 'level-one-core.html#ID-111237558', 'Node.nodeType')}} | {{Spec2('DOM1')}} | Définition initiale. | +## Compatibilité des navigateurs -

{{Compat("api.Node.nodeType")}}

+{{Compat("api.Node.nodeType")}} diff --git a/files/fr/web/api/node/nodevalue/index.md b/files/fr/web/api/node/nodevalue/index.md index 9f3fa1f3b3..294ed8619a 100644 --- a/files/fr/web/api/node/nodevalue/index.md +++ b/files/fr/web/api/node/nodevalue/index.md @@ -8,86 +8,81 @@ tags: - Propriétés translation_of: Web/API/Node/nodeValue --- -

{{APIRef("DOM")}}

+{{APIRef("DOM")}} -

La propriété Node.nodeValue renvoie ou définit la valeur du nœud courant.

+La propriété **`Node.nodeValue`** renvoie ou définit la valeur du nœud courant. -

Syntaxe

+## Syntaxe -
value = node.nodeValue;
-
+ value = node.nodeValue; -

value (valeur) est une chaîne contenant la valeur du nœud courant, s'il y en a une.

+`value` (_valeur_) est une chaîne contenant la valeur du nœud courant, s'il y en a une. -

Notes

+## Notes -

Pour le document lui-même, nodeValue renvoie null. Pour des nœuds texte, de commentaires et CDATA, nodeValue renvoie le contenu du nœud. Pour les nœuds d'attributs, il s'agira de la valeur de l'attribut.

+Pour le document lui-même, `nodeValue` renvoie `null`. Pour des nœuds texte, de commentaires et CDATA, `nodeValue` renvoie le contenu du nœud. Pour les nœuds d'attributs, il s'agira de la valeur de l'attribut. -

Le tableau suivant montre les valeurs de retour pour différents types de nœuds :

+Le tableau suivant montre les valeurs de retour pour différents types de nœuds : - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Attrvaleur de l'attribut
CDATASectioncontenu de la section CDATA
Commentcontenu du commentaire
Documentnull
DocumentFragmentnull
DocumentTypenull
Elementnull
NamedNodeMapnull
EntityReferencenull
Notationnull
ProcessingInstructiontout le contenu à l'exception de la cible
Textcontenu du nœud texte
Attrvaleur de l'attribut
CDATASectioncontenu de la section CDATA
Commentcontenu du commentaire
Documentnull
DocumentFragmentnull
DocumentTypenull
Elementnull
NamedNodeMapnull
EntityReferencenull
Notationnull
ProcessingInstructiontout le contenu à l'exception de la cible
Textcontenu du nœud texte
-

Lorsque nodeValue est défini comme étant null, l'assignation n'a aucun effet.

+Lorsque `nodeValue` est défini comme étant `null`, l'assignation n'a aucun effet. -

Spécification

+## Spécification - +- [DOM Level 2 Core: Node.nodeValue](http://www.w3.org/TR/DOM-Level-2-Core/core.html#ID-F68D080) — [traduction](http://www.yoyodesign.org/doc/w3c/dom2-core/core.html#ID-F68D080) (non normative) -

Compatibilité des navigateurs

+## Compatibilité des navigateurs - - -

{{Compat("api.Node.nodeValue")}}

+{{Compat("api.Node.nodeValue")}} diff --git a/files/fr/web/api/node/normalize/index.md b/files/fr/web/api/node/normalize/index.md index c1a299fb15..4864a1278a 100644 --- a/files/fr/web/api/node/normalize/index.md +++ b/files/fr/web/api/node/normalize/index.md @@ -3,20 +3,20 @@ title: element.normalize slug: Web/API/Node/normalize translation_of: Web/API/Node/normalize --- -

{{ ApiRef("DOM") }}

+{{ ApiRef("DOM") }} -

Résumé

+## Résumé -

Place le nœud spécifié et tout son sous-arbre dans une forme « normale ». Dans un sous-arbre normalisé, aucun nœud texte n'est vide et il n'y a pas de nœuds texte adjacents.

+Place le nœud spécifié et tout son sous-arbre dans une forme « normale ». Dans un sous-arbre normalisé, aucun nœud texte n'est vide et il n'y a pas de nœuds texte adjacents. -

Syntaxe

+## Syntaxe -
élément.normalize();
-
+ élément.normalize(); -

Exemple

+## Exemple -
var conteneur = document.createElement("div");
+```js
+var conteneur = document.createElement("div");
 conteneur.appendChild( document.createTextNode("Partie 1 ") );
 conteneu.appendChild( document.createTextNode("Partie 2 ") );
 
@@ -27,12 +27,11 @@ conteneu.appendChild( document.createTextNode("Partie 2 ") );
 conteneur.normalize();
 
 // À présent, conteneur.childNodes.length === 1
-// conteneur.childNodes[0].textContent === "Partie 1 Partie 2 "
+// conteneur.childNodes[0].textContent === "Partie 1 Partie 2 " +``` -

Notes

+## Notes -

Spécification

+## Spécification - \ No newline at end of file +- [DOM Level 2 Core: Node.normalize (en)](http://www.w3.org/TR/DOM-Level-2-Core/core.html#ID-normalize) — [traduction en français](http://www.yoyodesign.org/doc/w3c/dom2-core/core.html#ID-normalize) (non normative) diff --git a/files/fr/web/api/node/ownerdocument/index.md b/files/fr/web/api/node/ownerdocument/index.md index 35b5eb6859..83c9698497 100644 --- a/files/fr/web/api/node/ownerdocument/index.md +++ b/files/fr/web/api/node/ownerdocument/index.md @@ -9,58 +9,37 @@ tags: - Propriétés translation_of: Web/API/Node/ownerDocument --- -

{{APIRef("DOM")}}

+{{APIRef("DOM")}} -

La propriété en lecture seule Node.ownerDocument renvoie l'objet document de niveau supérieur pour ce nœud.

+La propriété en lecture seule **`Node.ownerDocument`** renvoie l'objet document de niveau supérieur pour ce nœud. -

Syntaxe

+## Syntaxe -
document = element.ownerDocument;
-
+ document = element.ownerDocument; -
    -
  • document est l'objet document parent de l'élément courant.
  • -
+- `document` est l'objet [`document`](/fr/docs/Web/API/document) parent de l'élément courant. -

Exemple

+## Exemple -
// étant donné un nœud "p", obtient le premier enfant HTML
+```html
+// étant donné un nœud "p", obtient le premier enfant HTML
 // de l'objet document
 var d = p.ownerDocument;
 var html = d.documentElement;
-
+``` -

Notes

+## Notes -

L'objet document renvoyé par cette propriété est l'objet principal avec lequel tous les nœuds enfants du document HTML réel sont créés. Si cette propriété est utilisée sur un nœud qui est lui-même un document, le résultat est null.

+L'objet `document` renvoyé par cette propriété est l'objet principal avec lequel tous les nœuds enfants du document HTML réel sont créés. Si cette propriété est utilisée sur un nœud qui est lui-même un document, le résultat est `null`. -

Spécifications

+### Spécifications - - - - - - - - - - - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName("DOM4", "#dom-node-ownerdocument", "Node.ownerDocument")}}{{Spec2("DOM4")}} 
{{SpecName("DOM3 Core", "core.html#node-ownerDoc", "Node.ownerDocument")}}{{Spec2("DOM3 Core")}}Pas de changement
{{SpecName("DOM2 Core", "core.html#node-ownerDoc", "Node.ownerDocument")}}{{Spec2("DOM2 Core")}}Définition initiale.
+| Spécification | Statut | Commentaire | +| ---------------------------------------------------------------------------------------------------- | ---------------------------- | -------------------- | +| {{SpecName("DOM4", "#dom-node-ownerdocument", "Node.ownerDocument")}} | {{Spec2("DOM4")}} |   | +| {{SpecName("DOM3 Core", "core.html#node-ownerDoc", "Node.ownerDocument")}} | {{Spec2("DOM3 Core")}} | Pas de changement | +| {{SpecName("DOM2 Core", "core.html#node-ownerDoc", "Node.ownerDocument")}} | {{Spec2("DOM2 Core")}} | Définition initiale. | -

Compatibilité des navigateurs

+## Compatibilité des navigateurs -

{{Compat("api.Node.ownerDocument")}}

\ No newline at end of file +{{Compat("api.Node.ownerDocument")}} diff --git a/files/fr/web/api/node/parentelement/index.md b/files/fr/web/api/node/parentelement/index.md index 673cb3b8b2..66d50067d3 100644 --- a/files/fr/web/api/node/parentelement/index.md +++ b/files/fr/web/api/node/parentelement/index.md @@ -9,45 +9,32 @@ tags: - parent translation_of: Web/API/Node/parentElement --- -
-
-
{{APIRef("DOM")}}
-
+{{APIRef("DOM")}}La propriété en lecture seule **`Node.parentElement`** renvoie le parent du noeud DOM ({{domxref("Element")}}) ou **`null`** si ce dernier n'a pas de parent ou si le parent n'est pas un {{domxref("Element")}} du DOM. -
La propriété en lecture seule Node.parentElement renvoie le parent du noeud DOM ({{domxref("Element")}}) ou null si ce dernier n'a pas de parent ou si le parent n'est pas un {{domxref("Element")}} du DOM.
-
+## Syntaxe -

Syntaxe

+ parentElement = node.parentElement -
parentElement = node.parentElement
-
+**`parentElement`** référence l'élément parent d'un nœud (**`node`**). C'est toujours un objet {{domxref("Element")}} du DOM ou `null`. -

parentElement référence l'élément parent d'un nœud (node). C'est toujours un objet {{domxref("Element")}} du DOM ou null.

+## Exemple -

Exemple

- -
if (node.parentElement) {
+```js
+if (node.parentElement) {
     node.parentElement.style.color = "red";
-}
- -

Compatibilité des navigateurs

- -

Sur quelques navigateurs, la propriété parentElement est seulement définie sur les noeuds qui sont eux-mêmes des {{domxref("Element")}}. En particulier, elle n'est pas définie sur les noeuds texte.

+} +``` -
+## Compatibilité des navigateurs +Sur quelques navigateurs, la propriété `parentElement` est seulement définie sur les noeuds qui sont eux-mêmes des {{domxref("Element")}}. En particulier, elle n'est pas définie sur les noeuds texte. -

{{Compat("api.Node.parentElement")}}

-
+{{Compat("api.Node.parentElement")}} -

Spécifications

+## Spécifications -
    -
  • {{spec("http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#parent-element", "DOM Level 4: Node.parentElement", "WD")}}
  • -
+- {{spec("http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#parent-element", "DOM Level 4: Node.parentElement", "WD")}} -

Voir aussi

+## Voir aussi -
    -
  • {{domxref("Node.parentNode")}}
  • -
+- {{domxref("Node.parentNode")}} diff --git a/files/fr/web/api/node/parentnode/index.md b/files/fr/web/api/node/parentnode/index.md index 5d2088cbf6..1412167bca 100644 --- a/files/fr/web/api/node/parentnode/index.md +++ b/files/fr/web/api/node/parentnode/index.md @@ -9,50 +9,47 @@ tags: - parent translation_of: Web/API/Node/parentNode --- -

{{APIRef("DOM")}}

+{{APIRef("DOM")}} -

La propriété en lecture seule parentNode renvoie le parent du nœud spécifié dans l'arborescence de DOM .

+La propriété en lecture seule **parentNode** renvoie le parent du nœud spécifié dans l'arborescence de DOM . -

Syntaxe

+## Syntaxe -
parentNode = node.parentNode
+ parentNode = node.parentNode -

parentNode est l'élément parent du nœud courant. Le parent d'un élément est un nœud Element , un nœud Document ou un nœud DocumentFragment .

+`parentNode` est l'élément parent du nœud courant. Le parent d'un élément est un nœud `Element` , un nœud `Document` ou un nœud `DocumentFragment` . -

Exemple

+## Exemple -
if (node.parentNode) {
-  // supprime un noeud  de l'arbre, 
+```js
+if (node.parentNode) {
+  // supprime un noeud  de l'arbre,
   // sauf s'il a déjà été supprimé
   node.parentNode.removeChild(node);
-}
+} +``` -

Notes

+## Notes -

Les noeuds Document et DocumentFragment ne peuvent jamais avoir de parent, alors  parentNode  retournera toujours null .

+Les [noeuds ](/en-US/docs/DOM/Node.nodeType)`Document` et `DocumentFragment` ne peuvent jamais avoir de parent, alors  `parentNode`  retournera toujours `null` . -

 Il renvoie également null si le nœud vient d'être créé et n'est pas encore attaché à l'arbre.

+Il renvoie également `null` si le nœud vient d'être créé et n'est pas encore attaché à l'arbre. -

Compatibilité des navigateurs

+## Compatibilité des navigateurs -

{{Compat("api.Node.parentNode")}}

+{{Compat("api.Node.parentNode")}} -

Spécification

- +## Spécification - +- [DOM Level 2 Core: Node.parentNode](http://www.w3.org/TR/DOM-Level-2-Core/core.html#ID-1060184317) +- [DOM Level 3 Core: Node.parentNode](http://www.w3.org/TR/DOM-Level-3-Core/core.html#ID-1060184317) -

Voir aussi

+## Voir aussi -
    -
  • {{Domxref("Node.firstChild")}}
  • -
  • {{Domxref("Node.lastChild")}}
  • -
  • {{Domxref("Node.childNodes")}}
  • -
  • {{Domxref("Node.nextSibling")}}
  • -
  • {{Domxref("Node.parentElement")}}
  • -
  • {{Domxref("Node.previousSibling")}}
  • -
  • {{Domxref("Node.removeChild")}}
  • -
\ No newline at end of file +- {{Domxref("Node.firstChild")}} +- {{Domxref("Node.lastChild")}} +- {{Domxref("Node.childNodes")}} +- {{Domxref("Node.nextSibling")}} +- {{Domxref("Node.parentElement")}} +- {{Domxref("Node.previousSibling")}} +- {{Domxref("Node.removeChild")}} diff --git a/files/fr/web/api/node/previoussibling/index.md b/files/fr/web/api/node/previoussibling/index.md index 31e02f5c7a..4b1e499e59 100644 --- a/files/fr/web/api/node/previoussibling/index.md +++ b/files/fr/web/api/node/previoussibling/index.md @@ -8,49 +8,46 @@ tags: - Propriétés translation_of: Web/API/Node/previousSibling --- -

{{APIRef("DOM")}}

+{{APIRef("DOM")}} -

La propriété en lecture seule  Node.previousSibling renvoie le nœud (node) précédant immédiatement le nœud courant dans la liste {{domxref("Node.childNodes", "childNodes")}} de son parent, ou null s'il s'agit du premier nœud de la liste.

+La propriété en lecture seule  **`Node.previousSibling`** renvoie le nœud (`node`) précédant immédiatement le nœud courant dans la liste {{domxref("Node.childNodes", "childNodes")}} de son parent, ou `null` s'il s'agit du premier nœud de la liste. -

Syntaxe

+## Syntaxe -
previousNode = node.previousSibling;
-
+ previousNode = node.previousSibling; -

Exemple

+## Exemple -
// <a><b1 id="b1"/><b2 id="b2"/></a>
+```js
+// 
 
 alert(document.getElementById("b1").previousSibling); // null
-alert(document.getElementById("b2").previousSibling.id); // "b1"
+alert(document.getElementById("b2").previousSibling.id); // "b1" +``` -

Notes

+## Notes -

Les navigateurs basés sur Gecko insèrent des nœuds texte dans un document pour représenter des espaces - vides dans le balisage source. Par conséquent, un nœud obtenu par exemple via Node.firstChild ou - Node.previousSibling peut faire référence à un nœud texte contenant des espaces plutôt qu'au véritable élément - que l'auteur comptait obtenir.

+Les navigateurs basés sur Gecko insèrent des nœuds texte dans un document pour représenter des espaces +vides dans le balisage source. Par conséquent, un nœud obtenu par exemple via [`Node.firstChild`](/fr/docs/Web/API/Node/firstChild) ou +[`Node.previousSibling`](/fr/docs/Web/API/Node/previousSibling "{{APIRef("DOM")}}") peut faire référence à un nœud texte contenant des espaces plutôt qu'au véritable élément +que l'auteur comptait obtenir. -

Consultez Gestion des espaces dans le DOM - et Why are some Text nodes empty? - dans la FAQ DOM 3 du W3C pour plus d'informations.

+Consultez [Gestion des espaces dans le DOM](/fr/docs/Gestion_des_espaces_dans_le_DOM) +et [_Why are some Text nodes empty?_ +dans la FAQ DOM 3 du W3C](http://www.w3.org/DOM/faq.html#emptytext) pour plus d'informations. -

L'opération inverse Node.nextSibling permet de rechercher l'élément suivant.

+L'opération inverse [`Node.nextSibling`](/fr/docs/Web/API/Node/nextSibling) permet de rechercher l'élément suivant. -

Spécifications

+## Spécifications - +- [DOM Level 1 Core: previousSibling](http://www.w3.org/TR/REC-DOM-Level-1/level-one-core.html#attribute-previousSibling) — [traduction](http://xmlfr.org/w3c/TR/REC-DOM-Level-1/level-one-core.html#attribute-previousSibling) (non normative) +- [DOM Level 2 Core: previousSibling](http://www.w3.org/TR/DOM-Level-2-Core/core.html#ID-640FB3C8) — [traduction](http://www.w3.org/TR/DOM-Level-2-Core/core.html#ID-640FB3C8) (non normative) +- [DOM Level 3 Core: previousSibling](http://www.w3.org/TR/DOM-Level-3-Core/core.html#ID-640FB3C8) -

Compatibilité des navigateurs

+## Compatibilité des navigateurs +{{Compat("api.Node.previousSibling")}} +## Voir aussi -

{{Compat("api.Node.previousSibling")}}

- -

Voir aussi

- -

{{domxref("Node.nextSibling")}}

+{{domxref("Node.nextSibling")}} diff --git a/files/fr/web/api/node/removechild/index.md b/files/fr/web/api/node/removechild/index.md index 051a65c4e6..727ad635d9 100644 --- a/files/fr/web/api/node/removechild/index.md +++ b/files/fr/web/api/node/removechild/index.md @@ -10,57 +10,53 @@ tags: - Suppression translation_of: Web/API/Node/removeChild --- -

{{ ApiRef("DOM") }}

+{{ ApiRef("DOM") }} -

La méthode Node.removeChild() retire un nœud enfant de l'arbre DOM et retourne le nœud retiré.

+La méthode **`Node.removeChild()`** retire un nœud enfant de l'arbre DOM et retourne le nœud retiré. -

Syntaxe

+## Syntaxe -
var oldChild = node.removeChild(child);
-OR
-node.removeChild(child);
-
+ var oldChild = node.removeChild(child); + OR + node.removeChild(child); -
    -
  • child est le nœud enfant à retirer du DOM.
  • -
  • node est le nœud parent de child.
  • -
  • oldchild conserve une référence au nœud enfant retiré. oldchild === child.
  • -
+- `child` est le nœud enfant à retirer du DOM. +- `node `est le nœud parent de `child`. +- `oldchild` conserve une référence au nœud enfant retiré. `oldchild` === `child`. -

Le nœud enfant retiré existe toujours en mémoire, mais ne fait plus partie du DOM. Avec la première syntaxe, il est possible de réutiliser ultérieurement dans le code le nœud retiré, à l'aide de la référence à l'objet ancienEnfant

+Le nœud enfant retiré existe toujours en mémoire, mais ne fait plus partie du DOM. Avec la première syntaxe, il est possible de réutiliser ultérieurement dans le code le nœud retiré, à l'aide de la référence à l'objet `ancienEnfant`_._ -

Avec la seconde forme montrée en exemple, aucune référence à l'objet ancienEnfant n'est conservée ; ainsi, en supposant que votre code n'a conservé nulle part ailleurs cette référence à ce nœud, il devient immédiatement inutilisable et irrécupérable, et sera en général automatiquement supprimé de la mémoire après un court moment.

+Avec la seconde forme montrée en exemple, aucune référence à l'objet `ancienEnfant` n'est conservée ; ainsi, en supposant que votre code n'a conservé nulle part ailleurs cette référence à ce nœud, il devient immédiatement inutilisable et irrécupérable, et sera en général [automatiquement supprimé](/fr/docs/Web/JavaScript/Gestion_de_la_m%C3%A9moire) de la mémoire après un court moment. -

Si  child n'est pas un enfant du noeud  element, la méthode provoque une exception. Une exception sera aussi lancée dans la cas où le nœud enfant est bien un enfant du nœud element au moment de l'appel à la méthode, mais qu'il a été retiré par un gestionnaire d'événement invoqué dans la cadre d'une tentative de suppression du nœud element (comme blur).

+Si  `child` n'est pas un enfant du noeud  `element`, la méthode provoque une exception. Une exception sera aussi lancée dans la cas où le nœud `enfant `est bien un enfant du nœud `element `au moment de l'appel à la méthode, mais qu'il a été retiré par un gestionnaire d'événement invoqué dans la cadre d'une tentative de suppression du nœud `element `(comme *blur*). -

La méthode peut lever une exception de deux façons :

+La méthode peut lever une exception de deux façons : -
    -
  1. Si enfant était bien un enfant de element et qu'il existe donc dans le DOM, mais qu'il a déjà été retiré, la méthode provoque l'exception suivante :​​
    - Uncaught NotFoundError: Failed to execute 'removeChild' on 'element': The node to be removed is not a child of this node.
  2. -
  3. si l'enfant n'existe pas dans le DOM de la page, la méthode provoque l'exception suivante :
    - Uncaught TypeError: Failed to execute 'removeChild' on 'element': parameter 1 is not of type 'Node'.
  4. -
+1. Si `enfant` était bien un enfant de element et qu'il existe donc dans le DOM, mais qu'il a déjà été retiré, la méthode provoque l'exception suivante :`​​` + `Uncaught NotFoundError: Failed to execute 'removeChild' on 'element': The node to be removed is not a child of this node`. +2. si l'`enfant` n'existe pas dans le DOM de la page, la méthode provoque l'exception suivante : + `Uncaught TypeError: Failed to execute 'removeChild' on 'element': parameter 1 is not of type 'Node'.` -

Exemples

+## Exemples -
<!--Sample HTML code-->
-<div id="top" align="center"> </div>
+```html
+
+
-<script type="text/javascript"> + -<!--Sample HTML code--> -<div id="top" align="center"> - <div id="nested"></div> -</div> + +
+
+
-<script type="text/javascript"> + +``` -
<!--Sample HTML code-->
+```html
+
 
-<div id="top" align="center">
-  <div id="nested"></div>
-</div>
+
+
+
+``` -
// Supprime un élément spécifié quand son noeud parent est connu
+```js
+// Supprime un élément spécifié quand son noeud parent est connu
 var d = document.getElementById("top");
 var d_nested = document.getElementById("nested");
-var throwawayNode = d.removeChild(d_nested);
+var throwawayNode = d.removeChild(d_nested); +``` -
// Supprime un élément spécifié sans avoir à spécifier son noeud parent
+```js
+// Supprime un élément spécifié sans avoir à spécifier son noeud parent
 var node = document.getElementById("nested");
 if (node.parentNode) {
   node.parentNode.removeChild(node);
-}
+} +``` -
+```js
 // Supprime tous les enfant d'un élément
 var element = document.getElementById("top");
 while (element.firstChild) {
   element.removeChild(element.firstChild);
-}
+} +``` -

Spécifications

+## Spécifications - +- [DOM Level 1 Core: removeChild](http://www.w3.org/TR/REC-DOM-Level-1/level-one-core.html#method-removeChild) — [traduction en français](http://xmlfr.org/w3c/TR/REC-DOM-Level-1/level-one-core.html#method-removeChild) (non normative) +- [DOM Level 2 Core: removeChild](http://www.w3.org/TR/DOM-Level-2-Core/core.html#ID-1734834066) — [traduction en français](http://www.yoyodesign.org/doc/w3c/dom2/core/core.html#ID-1734834066) (non normative) +- [DOM Level 3 Core: removeChild](http://www.w3.org/TR/DOM-Level-3-Core/core.html#ID-1734834066) -

Voir aussi

+## Voir aussi -
    -
  • {{domxref("Node.replaceChild")}}
  • -
  • {{domxref("Node.parentNode")}}
  • -
  • {{domxref("ChildNode.remove")}}
  • -
+- {{domxref("Node.replaceChild")}} +- {{domxref("Node.parentNode")}} +- {{domxref("ChildNode.remove")}} diff --git a/files/fr/web/api/node/replacechild/index.md b/files/fr/web/api/node/replacechild/index.md index 3cdf5aa950..492baac6d1 100644 --- a/files/fr/web/api/node/replacechild/index.md +++ b/files/fr/web/api/node/replacechild/index.md @@ -10,27 +10,25 @@ tags: - Remplacement translation_of: Web/API/Node/replaceChild --- -

{{APIRef("DOM")}}

+{{APIRef("DOM")}} -

La méthode Node.replaceChild() remplace un nœud enfant du noeud spécifié par un autre nœud.

+La méthode **`Node.replaceChild()`** remplace un nœud enfant du noeud spécifié par un autre nœud. -

Syntaxe

+## Syntaxe -
replacedNode = parentNode.replaceChild(newChild, oldChild);
-
+ replacedNode = parentNode.replaceChild(newChild, oldChild); -
    -
  • newChild est le nouveau nœud qui remplacera oldChild. S'il existe déjà dans le DOM, il sera d'abord enlevé.
  • -
  • oldChild est le nœud existant à remplacer.
  • -
  • replaceNode est le nœud remplacé. C'est le même nœud que oldChild.
  • -
+- `newChild` est le nouveau nœud qui remplacera `oldChild`. S'il existe déjà dans le DOM, il sera d'abord enlevé. +- `oldChild` est le nœud existant à remplacer. +- `replaceNode` est le nœud remplacé. C'est le même nœud que `oldChild`. -

Exemple

+## Exemple -
// Étant donné que :
-// <div>
-//   <span id="childSpan">foo bar</span>
-// </div>
+```js
+// Étant donné que :
+// 
+// foo bar +//
// Crée un nœud d'élément vide // sans ID, sans attributs et sans contenu @@ -53,38 +51,22 @@ var parentDiv = sp2.parentNode; parentDiv.replaceChild(sp1, sp2); // Résultat : -// <div> -// <span id="newSpan">nouvel élément span de remplacement.</span> -// </div> -
- -

Spécifications

- - - - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName("DOM WHATWG", "#dom-node-replacechild", "Node: replaceChild")}} - {{Spec2("DOM WHATWG")}}
- -

Compatibilité des navigateurs

- -

{{Compat("api.Node.replaceChild")}}

- -

Voir aussi

- -
    -
  • {{domxref("Node.removeChild")}}
  • -
  • {{domxref("ChildNode.replaceWith")}}
  • -
+//
+// nouvel élément span de remplacement. +//
+``` + +## Spécifications + +| Spécification | Statut | Commentaire | +| ---------------------------------------------------------------------------------------------------- | -------------------------------- | ----------- | +| {{SpecName("DOM WHATWG", "#dom-node-replacechild", "Node: replaceChild")}} | {{Spec2("DOM WHATWG")}} | | + +## Compatibilité des navigateurs + +{{Compat("api.Node.replaceChild")}} + +## Voir aussi + +- {{domxref("Node.removeChild")}} +- {{domxref("ChildNode.replaceWith")}} diff --git a/files/fr/web/api/node/textcontent/index.md b/files/fr/web/api/node/textcontent/index.md index 63e892d5b6..0b195eaa7a 100644 --- a/files/fr/web/api/node/textcontent/index.md +++ b/files/fr/web/api/node/textcontent/index.md @@ -8,61 +8,56 @@ tags: - Propriétés translation_of: Web/API/Node/textContent --- -

{{APIRef("DOM")}}

+{{APIRef("DOM")}} -

La propriété Node.textContent  représente le contenu textuel d'un nœud et de ses descendants.

+La propriété **`Node.textContent`**  représente le contenu textuel d'un nœud et de ses descendants. -

Syntaxe

+## Syntaxe -
var text = element.textContent;
-element.textContent = "ceci est un simple exemple de texte";
-
+ var text = element.textContent; + element.textContent = "ceci est un simple exemple de texte"; -

Description

+## Description -
    -
  • textContent renvoie null si l'élément est un document, un type de document (doctype) ou une notation. Pour saisir toutes les données textuelles et CDATA pour l'ensemble du document, on peut utiliser document.documentElement.textContent .
  • -
  • Si le nœud est une section CDATA, un commentaire, une instruction de traitement ou un nœud texte, textContent renvoie le texte à l'intérieur du nœud (la valeur nodeValue).
  • -
  • Pour les autres types de nœuds, textContent renvoie la concaténation des valeurs de propriété textContent de chaque nœud enfant, à l'exception des commentaires et nœuds d'instructions de traitement. Si le nœud n'a pas d'enfants, il s'agira d'une chaîne vide.
  • -
  • En définissant cette propriété sur un nœud, on enlève tous ses enfants et ceux-ci sont remplacés par un seul nœud texte avec la valeur donnée.
  • -
+- `textContent` renvoie `null` si l'élément est un [document](/fr/docs/Web/API/document), un type de document (doctype) ou une notation. Pour saisir toutes les données textuelles et CDATA pour l'ensemble du document, on peut utiliser `document.documentElement.textContent` . +- Si le nœud est une section CDATA, un commentaire, une instruction de traitement ou un nœud texte, `textContent` renvoie le texte à l'intérieur du nœud (la valeur [nodeValue](/fr/docs/Web/API/Node/nodeValue)). +- Pour les autres types de nœuds, `textContent` renvoie la concaténation des valeurs de propriété `textContent` de chaque nœud enfant, à l'exception des commentaires et nœuds d'instructions de traitement. Si le nœud n'a pas d'enfants, il s'agira d'une chaîne vide. +- En définissant cette propriété sur un nœud, on enlève tous ses enfants et ceux-ci sont remplacés par un seul nœud texte avec la valeur donnée. -

Différences avec innerText

+### Différences avec `innerText` -

Internet Explorer a introduit une propriété {{domxref("node.innerText")}}. L'intention est similaire mais comporte les différences suivantes :

+Internet Explorer a introduit une propriété {{domxref("node.innerText")}}. L'intention est similaire mais comporte les différences suivantes : -
    -
  • textContent récupère le contenu de tous les éléments, y compris {{HTMLElement("script")}} et {{HTMLElement("style")}}, ce qui n'est pas le cas de innerText.
  • -
  • innerText prend en compte le style de l'élément et ne retournera rien pour les éléments cachés. Aussi, il déclenchera un reflow à l'inverse de textContent.
  • -
  • Comme innerText reconnaît le style CSS, il déclenchera une refusion (reflow), alors que textContent ne le fera pas.
  • -
  • Contrairement à textContent, la modification innerText dans Internet Explorer (jusqu'à la version 11 incluse), non seulement supprime les nœuds enfants de l'élément, mais détruit aussi définitivement tout nœud de texte descendant (il est donc impossible d'insérer à nouveau des nœuds dans un autre élément ou dans le même élément) .
  • -
+- `textContent` récupère le contenu de tous les éléments, y compris {{HTMLElement("script")}} et {{HTMLElement("style")}}, ce qui n'est pas le cas de `innerText`. +- `innerText` prend en compte le style de l'élément et ne retournera rien pour les éléments cachés. Aussi, il déclenchera un reflow à l'inverse de `textContent`. +- Comme `innerText` reconnaît le style CSS, il déclenchera une refusion (_reflow_), alors que `textContent` ne le fera pas. +- Contrairement à `textContent`, la modification `innerText` dans Internet Explorer (jusqu'à la version 11 incluse), non seulement supprime les nœuds enfants de l'élément, mais détruit aussi définitivement tout nœud de texte descendant (il est donc impossible d'insérer à nouveau des nœuds dans un autre élément ou dans le même élément) . -

Différences avec innerHTML

+### Différences avec `innerHTML` -

{{domxref("Element.innerHTML")}} renvoie le HTML comme son nom l'indique. Souvent, pour récupérer ou écrire du texte dans un élément, les utilisateurs utilisent innerHTML. Cependant, textContent a souvent de meilleures performances car le texte n'est pas analysé en HTML. De plus, l'utilisation de textContent peut empêcher les attaques XSS.

+{{domxref("Element.innerHTML")}} renvoie le HTML comme son nom l'indique. Souvent, pour récupérer ou écrire du texte dans un élément, les utilisateurs utilisent `innerHTML`. Cependant, `textContent` a souvent de meilleures performances car le texte n'est pas analysé en HTML. De plus, l'utilisation de `textContent` peut empêcher les attaques XSS. -

Exemple

+## Exemple -
// Étant donné le fragment de HTML suivant :
-//   <div id="divA">Ceci est un <span>exemple de</span> texte</div>
+    // Étant donné le fragment de HTML suivant :
+    //   
Ceci est un exemple de texte
-// On obtient le contenu textuel : -var text = document.getElementById("divA").textContent; -// |text| vaut "Ceci est un exemple de texte". + // On obtient le contenu textuel : + var text = document.getElementById("divA").textContent; + // |text| vaut "Ceci est un exemple de texte". -// On définit le contenu textuel : -document.getElementById("divA").textContent = "Ceci est un exemple de texte"; -// Le HTML pour divA est à présent <div id="divA">Ceci est un exemple de texte</div> -
+ // On définit le contenu textuel : + document.getElementById("divA").textContent = "Ceci est un exemple de texte"; + // Le HTML pour divA est à présent
Ceci est un exemple de texte
-

Polyfill pour IE8

+## Polyfill pour IE8 -
// Source: Eli Grey @ http://eligrey.com/blog/post/textcontent-in-ie8
+```js
+// Source: Eli Grey @ http://eligrey.com/blog/post/textcontent-in-ie8
 if (Object.defineProperty
-  && Object.getOwnPropertyDescriptor
-  && Object.getOwnPropertyDescriptor(Element.prototype, "textContent")
-  && !Object.getOwnPropertyDescriptor(Element.prototype, "textContent").get) {
+  && Object.getOwnPropertyDescriptor
+  && Object.getOwnPropertyDescriptor(Element.prototype, "textContent")
+  && !Object.getOwnPropertyDescriptor(Element.prototype, "textContent").get) {
   (function() {
     var innerText = Object.getOwnPropertyDescriptor(Element.prototype, "innerText");
     Object.defineProperty(Element.prototype, "textContent",
@@ -78,48 +73,21 @@ if (Object.defineProperty
      }
    );
   })();
-}
- -
    -
- -

Compatibilité des navigateurs

- - - -

{{Compat("api.Node.textContent")}}

- -

Spécifications

- - - - - - - - - - - - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('DOM WHATWG','#dom-node-textcontent','Node.textContent')}}{{Spec2('DOM WHATWG')}}Pas de changement de DOM4
{{SpecName('DOM4','#dom-node-textcontent','Node.textContent')}}{{Spec2('DOM4')}} 
{{SpecName('DOM3 Core','core.html#Node3-textContent','Node.textContent')}}{{Spec2('DOM3 Core')}}Définition initiale.
- -

Voir aussi

- - - -

 

+} +``` + +## Compatibilité des navigateurs + +{{Compat("api.Node.textContent")}} + +## Spécifications + +| Spécification | Statut | Commentaire | +| ---------------------------------------------------------------------------------------------------- | -------------------------------- | ------------------------- | +| {{SpecName('DOM WHATWG','#dom-node-textcontent','Node.textContent')}} | {{Spec2('DOM WHATWG')}} | Pas de changement de DOM4 | +| {{SpecName('DOM4','#dom-node-textcontent','Node.textContent')}} | {{Spec2('DOM4')}} |   | +| {{SpecName('DOM3 Core','core.html#Node3-textContent','Node.textContent')}} | {{Spec2('DOM3 Core')}} | Définition initiale. | + +## Voir aussi + +- [Plus sur les différences entre `innerText` et `textContent`](http://perfectionkills.com/the-poor-misunderstood-innerText/) (blog post en) -- cgit v1.2.3-54-g00ecf