From c05efa8d7ae464235cf83d7c0956e42dc6974103 Mon Sep 17 00:00:00 2001 From: julieng Date: Sat, 2 Oct 2021 17:20:14 +0200 Subject: move *.html to *.md --- files/fr/web/api/node/appendchild/index.html | 99 ------- files/fr/web/api/node/appendchild/index.md | 99 +++++++ files/fr/web/api/node/baseuri/index.html | 71 ----- files/fr/web/api/node/baseuri/index.md | 71 +++++ files/fr/web/api/node/childnodes/index.html | 103 ------- files/fr/web/api/node/childnodes/index.md | 103 +++++++ files/fr/web/api/node/clonenode/index.html | 92 ------- files/fr/web/api/node/clonenode/index.md | 92 +++++++ .../api/node/comparedocumentposition/index.html | 108 -------- .../web/api/node/comparedocumentposition/index.md | 108 ++++++++ files/fr/web/api/node/contains/index.html | 57 ---- files/fr/web/api/node/contains/index.md | 57 ++++ files/fr/web/api/node/firstchild/index.html | 88 ------ files/fr/web/api/node/firstchild/index.md | 88 ++++++ files/fr/web/api/node/getrootnode/index.html | 89 ------ files/fr/web/api/node/getrootnode/index.md | 89 ++++++ files/fr/web/api/node/haschildnodes/index.html | 78 ------ files/fr/web/api/node/haschildnodes/index.md | 78 ++++++ files/fr/web/api/node/index.html | 306 --------------------- files/fr/web/api/node/index.md | 306 +++++++++++++++++++++ files/fr/web/api/node/insertbefore/index.html | 166 ----------- files/fr/web/api/node/insertbefore/index.md | 166 +++++++++++ files/fr/web/api/node/isconnected/index.html | 96 ------- files/fr/web/api/node/isconnected/index.md | 96 +++++++ .../fr/web/api/node/isdefaultnamespace/index.html | 39 --- files/fr/web/api/node/isdefaultnamespace/index.md | 39 +++ files/fr/web/api/node/isequalnode/index.html | 90 ------ files/fr/web/api/node/isequalnode/index.md | 90 ++++++ files/fr/web/api/node/issamenode/index.html | 93 ------- files/fr/web/api/node/issamenode/index.md | 93 +++++++ files/fr/web/api/node/issupported/index.html | 78 ------ files/fr/web/api/node/issupported/index.md | 78 ++++++ files/fr/web/api/node/lastchild/index.html | 66 ----- files/fr/web/api/node/lastchild/index.md | 66 +++++ .../fr/web/api/node/lookupnamespaceuri/index.html | 23 -- files/fr/web/api/node/lookupnamespaceuri/index.md | 23 ++ files/fr/web/api/node/lookupprefix/index.html | 23 -- files/fr/web/api/node/lookupprefix/index.md | 23 ++ files/fr/web/api/node/nextsibling/index.html | 83 ------ files/fr/web/api/node/nextsibling/index.md | 83 ++++++ files/fr/web/api/node/nodename/index.html | 111 -------- files/fr/web/api/node/nodename/index.md | 111 ++++++++ files/fr/web/api/node/nodetype/index.html | 180 ------------ files/fr/web/api/node/nodetype/index.md | 180 ++++++++++++ files/fr/web/api/node/nodevalue/index.html | 93 ------- files/fr/web/api/node/nodevalue/index.md | 93 +++++++ files/fr/web/api/node/normalize/index.html | 38 --- files/fr/web/api/node/normalize/index.md | 38 +++ files/fr/web/api/node/ownerdocument/index.html | 66 ----- files/fr/web/api/node/ownerdocument/index.md | 66 +++++ files/fr/web/api/node/parentelement/index.html | 53 ---- files/fr/web/api/node/parentelement/index.md | 53 ++++ files/fr/web/api/node/parentnode/index.html | 58 ---- files/fr/web/api/node/parentnode/index.md | 58 ++++ files/fr/web/api/node/previoussibling/index.html | 56 ---- files/fr/web/api/node/previoussibling/index.md | 56 ++++ files/fr/web/api/node/removechild/index.html | 112 -------- files/fr/web/api/node/removechild/index.md | 112 ++++++++ files/fr/web/api/node/replacechild/index.html | 90 ------ files/fr/web/api/node/replacechild/index.md | 90 ++++++ files/fr/web/api/node/textcontent/index.html | 125 --------- files/fr/web/api/node/textcontent/index.md | 125 +++++++++ 62 files changed, 2830 insertions(+), 2830 deletions(-) delete mode 100644 files/fr/web/api/node/appendchild/index.html create mode 100644 files/fr/web/api/node/appendchild/index.md delete mode 100644 files/fr/web/api/node/baseuri/index.html create mode 100644 files/fr/web/api/node/baseuri/index.md delete mode 100644 files/fr/web/api/node/childnodes/index.html create mode 100644 files/fr/web/api/node/childnodes/index.md delete mode 100644 files/fr/web/api/node/clonenode/index.html create mode 100644 files/fr/web/api/node/clonenode/index.md delete mode 100644 files/fr/web/api/node/comparedocumentposition/index.html create mode 100644 files/fr/web/api/node/comparedocumentposition/index.md delete mode 100644 files/fr/web/api/node/contains/index.html create mode 100644 files/fr/web/api/node/contains/index.md delete mode 100644 files/fr/web/api/node/firstchild/index.html create mode 100644 files/fr/web/api/node/firstchild/index.md delete mode 100644 files/fr/web/api/node/getrootnode/index.html create mode 100644 files/fr/web/api/node/getrootnode/index.md delete mode 100644 files/fr/web/api/node/haschildnodes/index.html create mode 100644 files/fr/web/api/node/haschildnodes/index.md delete mode 100644 files/fr/web/api/node/index.html create mode 100644 files/fr/web/api/node/index.md delete mode 100644 files/fr/web/api/node/insertbefore/index.html create mode 100644 files/fr/web/api/node/insertbefore/index.md delete mode 100644 files/fr/web/api/node/isconnected/index.html create mode 100644 files/fr/web/api/node/isconnected/index.md delete mode 100644 files/fr/web/api/node/isdefaultnamespace/index.html create mode 100644 files/fr/web/api/node/isdefaultnamespace/index.md delete mode 100644 files/fr/web/api/node/isequalnode/index.html create mode 100644 files/fr/web/api/node/isequalnode/index.md delete mode 100644 files/fr/web/api/node/issamenode/index.html create mode 100644 files/fr/web/api/node/issamenode/index.md delete mode 100644 files/fr/web/api/node/issupported/index.html create mode 100644 files/fr/web/api/node/issupported/index.md delete mode 100644 files/fr/web/api/node/lastchild/index.html create mode 100644 files/fr/web/api/node/lastchild/index.md delete mode 100644 files/fr/web/api/node/lookupnamespaceuri/index.html create mode 100644 files/fr/web/api/node/lookupnamespaceuri/index.md delete mode 100644 files/fr/web/api/node/lookupprefix/index.html create mode 100644 files/fr/web/api/node/lookupprefix/index.md delete mode 100644 files/fr/web/api/node/nextsibling/index.html create mode 100644 files/fr/web/api/node/nextsibling/index.md delete mode 100644 files/fr/web/api/node/nodename/index.html create mode 100644 files/fr/web/api/node/nodename/index.md delete mode 100644 files/fr/web/api/node/nodetype/index.html create mode 100644 files/fr/web/api/node/nodetype/index.md delete mode 100644 files/fr/web/api/node/nodevalue/index.html create mode 100644 files/fr/web/api/node/nodevalue/index.md delete mode 100644 files/fr/web/api/node/normalize/index.html create mode 100644 files/fr/web/api/node/normalize/index.md delete mode 100644 files/fr/web/api/node/ownerdocument/index.html create mode 100644 files/fr/web/api/node/ownerdocument/index.md delete mode 100644 files/fr/web/api/node/parentelement/index.html create mode 100644 files/fr/web/api/node/parentelement/index.md delete mode 100644 files/fr/web/api/node/parentnode/index.html create mode 100644 files/fr/web/api/node/parentnode/index.md delete mode 100644 files/fr/web/api/node/previoussibling/index.html create mode 100644 files/fr/web/api/node/previoussibling/index.md delete mode 100644 files/fr/web/api/node/removechild/index.html create mode 100644 files/fr/web/api/node/removechild/index.md delete mode 100644 files/fr/web/api/node/replacechild/index.html create mode 100644 files/fr/web/api/node/replacechild/index.md delete mode 100644 files/fr/web/api/node/textcontent/index.html create mode 100644 files/fr/web/api/node/textcontent/index.md (limited to 'files/fr/web/api/node') diff --git a/files/fr/web/api/node/appendchild/index.html b/files/fr/web/api/node/appendchild/index.html deleted file mode 100644 index 800be4c3bb..0000000000 --- a/files/fr/web/api/node/appendchild/index.html +++ /dev/null @@ -1,99 +0,0 @@ ---- -title: element.appendChild -slug: Web/API/Node/appendChild -tags: - - API - - Ajout - - DOM - - Enfant - - Méthodes - - Noeuds -translation_of: Web/API/Node/appendChild ---- -

{{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).

- -

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

- -

Syntaxe

- -
var elementAjoute = element.appendChild(enfant);
-
- -

Paramètres

- -
-
enfant
-
Le noeud à ajouter au noeud parent donné (généralement un élément).
-
- -

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

- -

Notes

- -

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'));
- -

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

- -

Exemple

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

- - diff --git a/files/fr/web/api/node/appendchild/index.md b/files/fr/web/api/node/appendchild/index.md new file mode 100644 index 0000000000..800be4c3bb --- /dev/null +++ b/files/fr/web/api/node/appendchild/index.md @@ -0,0 +1,99 @@ +--- +title: element.appendChild +slug: Web/API/Node/appendChild +tags: + - API + - Ajout + - DOM + - Enfant + - Méthodes + - Noeuds +translation_of: Web/API/Node/appendChild +--- +

{{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).

+ +

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

+ +

Syntaxe

+ +
var elementAjoute = element.appendChild(enfant);
+
+ +

Paramètres

+ +
+
enfant
+
Le noeud à ajouter au noeud parent donné (généralement un élément).
+
+ +

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

+ +

Notes

+ +

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'));
+ +

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

+ +

Exemple

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

+ + diff --git a/files/fr/web/api/node/baseuri/index.html b/files/fr/web/api/node/baseuri/index.html deleted file mode 100644 index 68cf5be1bc..0000000000 --- a/files/fr/web/api/node/baseuri/index.html +++ /dev/null @@ -1,71 +0,0 @@ ---- -title: Node.baseURI -slug: Web/API/Node/baseURI -tags: - - API - - DOM - - HTML - - Propriétés - - URI - - URL - - URL absolue - - XML -translation_of: Web/API/Node/baseURI ---- -
-
{{APIRef("DOM")}}
-
- -

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.

- -

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.

- -

Syntaxe

- -
var baseURI = node.baseURI;
-
- - - -

Détails

- -

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 :

- - - -

Voir la page Base URLs section of the HTML Living standard (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.

- -

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.

- -

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.

- -

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

- -

Spécification

- - - -

Voir aussi

- - diff --git a/files/fr/web/api/node/baseuri/index.md b/files/fr/web/api/node/baseuri/index.md new file mode 100644 index 0000000000..68cf5be1bc --- /dev/null +++ b/files/fr/web/api/node/baseuri/index.md @@ -0,0 +1,71 @@ +--- +title: Node.baseURI +slug: Web/API/Node/baseURI +tags: + - API + - DOM + - HTML + - Propriétés + - URI + - URL + - URL absolue + - XML +translation_of: Web/API/Node/baseURI +--- +
+
{{APIRef("DOM")}}
+
+ +

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.

+ +

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.

+ +

Syntaxe

+ +
var baseURI = node.baseURI;
+
+ + + +

Détails

+ +

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 :

+ + + +

Voir la page Base URLs section of the HTML Living standard (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.

+ +

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.

+ +

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.

+ +

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

+ +

Spécification

+ + + +

Voir aussi

+ + diff --git a/files/fr/web/api/node/childnodes/index.html b/files/fr/web/api/node/childnodes/index.html deleted file mode 100644 index b9f4630ffc..0000000000 --- a/files/fr/web/api/node/childnodes/index.html +++ /dev/null @@ -1,103 +0,0 @@ ---- -title: element.childNodes -slug: Web/API/Node/childNodes -tags: - - API - - DOM - - Enfants - - Noeuds - - Propriétés -translation_of: Web/API/Node/childNodes ---- -

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

- -

Syntaxe

- -
var collNoeuds = elementDeReference.childNodes;
-
- -

Exemples

- -

Utilisation simple

- -
// parg est une référence d'objet pour un élément <p>
-
-// 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++) {
-    // 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

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

- - diff --git a/files/fr/web/api/node/childnodes/index.md b/files/fr/web/api/node/childnodes/index.md new file mode 100644 index 0000000000..b9f4630ffc --- /dev/null +++ b/files/fr/web/api/node/childnodes/index.md @@ -0,0 +1,103 @@ +--- +title: element.childNodes +slug: Web/API/Node/childNodes +tags: + - API + - DOM + - Enfants + - Noeuds + - Propriétés +translation_of: Web/API/Node/childNodes +--- +

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

+ +

Syntaxe

+ +
var collNoeuds = elementDeReference.childNodes;
+
+ +

Exemples

+ +

Utilisation simple

+ +
// parg est une référence d'objet pour un élément <p>
+
+// 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++) {
+    // 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

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

+ + diff --git a/files/fr/web/api/node/clonenode/index.html b/files/fr/web/api/node/clonenode/index.html deleted file mode 100644 index fef79935dc..0000000000 --- a/files/fr/web/api/node/clonenode/index.html +++ /dev/null @@ -1,92 +0,0 @@ ---- -title: element.cloneNode -slug: Web/API/Node/cloneNode -tags: - - API - - DOM - - Duplication - - Méthodes - - Noeuds -translation_of: Web/API/Node/cloneNode ---- -

{{APIRef("DOM")}}

- -

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

- -

Syntaxe

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

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.

-
- -

Exemple

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

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() 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.

- -

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.

- -
-

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.

- -

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

- -

Spécification

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

- -

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

diff --git a/files/fr/web/api/node/clonenode/index.md b/files/fr/web/api/node/clonenode/index.md new file mode 100644 index 0000000000..fef79935dc --- /dev/null +++ b/files/fr/web/api/node/clonenode/index.md @@ -0,0 +1,92 @@ +--- +title: element.cloneNode +slug: Web/API/Node/cloneNode +tags: + - API + - DOM + - Duplication + - Méthodes + - Noeuds +translation_of: Web/API/Node/cloneNode +--- +

{{APIRef("DOM")}}

+ +

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

+ +

Syntaxe

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

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.

+
+ +

Exemple

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

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() 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.

+ +

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.

+ +
+

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.

+ +

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

+ +

Spécification

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

+ +

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

diff --git a/files/fr/web/api/node/comparedocumentposition/index.html b/files/fr/web/api/node/comparedocumentposition/index.html deleted file mode 100644 index a40125b5c1..0000000000 --- a/files/fr/web/api/node/comparedocumentposition/index.html +++ /dev/null @@ -1,108 +0,0 @@ ---- -title: Node.compareDocumentPosition() -slug: Web/API/Node/compareDocumentPosition -tags: - - API - - Arborescence - - DOM - - Méthodes - - Noeuds - - 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) {
-  console.log("well-formed document");
-} else {
-  console.log("<head> is not before <body>");
-}
-
- -
-

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

- - diff --git a/files/fr/web/api/node/comparedocumentposition/index.md b/files/fr/web/api/node/comparedocumentposition/index.md new file mode 100644 index 0000000000..a40125b5c1 --- /dev/null +++ b/files/fr/web/api/node/comparedocumentposition/index.md @@ -0,0 +1,108 @@ +--- +title: Node.compareDocumentPosition() +slug: Web/API/Node/compareDocumentPosition +tags: + - API + - Arborescence + - DOM + - Méthodes + - Noeuds + - 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) {
+  console.log("well-formed document");
+} else {
+  console.log("<head> is not before <body>");
+}
+
+ +
+

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

+ + diff --git a/files/fr/web/api/node/contains/index.html b/files/fr/web/api/node/contains/index.html deleted file mode 100644 index e5906fbf28..0000000000 --- a/files/fr/web/api/node/contains/index.html +++ /dev/null @@ -1,57 +0,0 @@ ---- -title: Node.contains -slug: Web/API/Node/contains -tags: - - API - - DOM - - Filiation - - Méthodes - - Noeuds -translation_of: Web/API/Node/contains ---- -
{{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.
- -

Syntaxe

- -
node.contains( otherNode )
-
- -

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.

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

- - diff --git a/files/fr/web/api/node/contains/index.md b/files/fr/web/api/node/contains/index.md new file mode 100644 index 0000000000..e5906fbf28 --- /dev/null +++ b/files/fr/web/api/node/contains/index.md @@ -0,0 +1,57 @@ +--- +title: Node.contains +slug: Web/API/Node/contains +tags: + - API + - DOM + - Filiation + - Méthodes + - Noeuds +translation_of: Web/API/Node/contains +--- +
{{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.
+ +

Syntaxe

+ +
node.contains( otherNode )
+
+ +

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.

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

+ + diff --git a/files/fr/web/api/node/firstchild/index.html b/files/fr/web/api/node/firstchild/index.html deleted file mode 100644 index 03550acf9f..0000000000 --- a/files/fr/web/api/node/firstchild/index.html +++ /dev/null @@ -1,88 +0,0 @@ ---- -title: element.firstChild -slug: Web/API/Node/firstChild -tags: - - API - - DOM - - Enfant - - Noeuds - - Propriété -translation_of: Web/API/Node/firstChild ---- -

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

- -

Syntaxe

- -
var childNode = node.firstChild;
- -

Exemple

- -

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>
-
-<script type="text/javascript">
-  var p01 = document.getElementById('para-01');
-  alert(p01.firstChild.nodeName)
-</script>
-
- -

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.

- -

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

- -

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>
-
-<script type="text/javascript">
-  var p01 = document.getElementById('para-01');
-  alert(p01.firstChild.nodeName)
-</script>
-
- -

À 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écificationStatutCommentaire
{{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")}}

\ No newline at end of file diff --git a/files/fr/web/api/node/firstchild/index.md b/files/fr/web/api/node/firstchild/index.md new file mode 100644 index 0000000000..03550acf9f --- /dev/null +++ b/files/fr/web/api/node/firstchild/index.md @@ -0,0 +1,88 @@ +--- +title: element.firstChild +slug: Web/API/Node/firstChild +tags: + - API + - DOM + - Enfant + - Noeuds + - Propriété +translation_of: Web/API/Node/firstChild +--- +

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

+ +

Syntaxe

+ +
var childNode = node.firstChild;
+ +

Exemple

+ +

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>
+
+<script type="text/javascript">
+  var p01 = document.getElementById('para-01');
+  alert(p01.firstChild.nodeName)
+</script>
+
+ +

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.

+ +

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

+ +

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>
+
+<script type="text/javascript">
+  var p01 = document.getElementById('para-01');
+  alert(p01.firstChild.nodeName)
+</script>
+
+ +

À 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écificationStatutCommentaire
{{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")}}

\ No newline at end of file diff --git a/files/fr/web/api/node/getrootnode/index.html b/files/fr/web/api/node/getrootnode/index.html deleted file mode 100644 index 5a6297d55b..0000000000 --- a/files/fr/web/api/node/getrootnode/index.html +++ /dev/null @@ -1,89 +0,0 @@ ---- -title: Node.getRootNode() -slug: Web/API/Node/getRootNode -tags: - - API - - DOM - - Méthodes - - Noeuds - - Racine -translation_of: Web/API/Node/getRootNode ---- -

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

- -

Syntaxe

- -
var root = node.getRootNode(options)
- -

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).
    • -
-
-
- -

Retourne

- -

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

- -

Exemple

- -

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

- -
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):

- -
<!-- 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>
-    // work on Chrome 54+，Opera41+
-
-    var parent = document.querySelector('.js-parent'),
-        child = document.querySelector('.js-child'),
-        shadowHost = document.querySelector('.js-shadowHost');
-
-    console.log(parent.getRootNode().nodeName); // #document
-    console.log(child.getRootNode().nodeName); // #document
-
-    // create a ShadowRoot
-    var shadowRoot = shadowHost.attachShadow({mode:'open'});
-    shadowRoot.innerHTML = '<style>div{background:#2bb8aa;}</style>'
-        + '<div class="js-shadowChild">content</div>';
-    var shadowChild = shadowRoot.querySelector('.js-shadowChild');
-
-    // The default value of composed is false
-    console.log(shadowChild.getRootNode() === shadowRoot); // true
-    console.log(shadowChild.getRootNode({composed:false}) === shadowRoot); // true
-    console.log(shadowChild.getRootNode({composed:true}).nodeName); // #document
-</script>
- -

Spécifications

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

Compatibilité des navigateurs

- -

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

\ No newline at end of file diff --git a/files/fr/web/api/node/getrootnode/index.md b/files/fr/web/api/node/getrootnode/index.md new file mode 100644 index 0000000000..5a6297d55b --- /dev/null +++ b/files/fr/web/api/node/getrootnode/index.md @@ -0,0 +1,89 @@ +--- +title: Node.getRootNode() +slug: Web/API/Node/getRootNode +tags: + - API + - DOM + - Méthodes + - Noeuds + - Racine +translation_of: Web/API/Node/getRootNode +--- +

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

+ +

Syntaxe

+ +
var root = node.getRootNode(options)
+ +

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

Retourne

+ +

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

+ +

Exemple

+ +

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

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

+ +
<!-- 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>
+    // work on Chrome 54+，Opera41+
+
+    var parent = document.querySelector('.js-parent'),
+        child = document.querySelector('.js-child'),
+        shadowHost = document.querySelector('.js-shadowHost');
+
+    console.log(parent.getRootNode().nodeName); // #document
+    console.log(child.getRootNode().nodeName); // #document
+
+    // create a ShadowRoot
+    var shadowRoot = shadowHost.attachShadow({mode:'open'});
+    shadowRoot.innerHTML = '<style>div{background:#2bb8aa;}</style>'
+        + '<div class="js-shadowChild">content</div>';
+    var shadowChild = shadowRoot.querySelector('.js-shadowChild');
+
+    // The default value of composed is false
+    console.log(shadowChild.getRootNode() === shadowRoot); // true
+    console.log(shadowChild.getRootNode({composed:false}) === shadowRoot); // true
+    console.log(shadowChild.getRootNode({composed:true}).nodeName); // #document
+</script>
+ +

Spécifications

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

Compatibilité des navigateurs

+ +

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

\ No newline at end of file diff --git a/files/fr/web/api/node/haschildnodes/index.html b/files/fr/web/api/node/haschildnodes/index.html deleted file mode 100644 index c14ad9836f..0000000000 --- a/files/fr/web/api/node/haschildnodes/index.html +++ /dev/null @@ -1,78 +0,0 @@ ---- -title: element.hasChildNodes -slug: Web/API/Node/hasChildNodes -tags: - - API - - DOM - - Method - - NeedsSpecTable - - Node - - Reference -translation_of: Web/API/Node/hasChildNodes ---- -

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

- -

Syntaxe

- -
bool = node.hasChildNodes();
- -

Valeur de retour

- -

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

- -

Exemple

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

Prothèse d'émulation

- -
(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 :

- - - -

Spécification

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

Compatibilité des navigateurs

- -

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

- -

Voir aussi

- - diff --git a/files/fr/web/api/node/haschildnodes/index.md b/files/fr/web/api/node/haschildnodes/index.md new file mode 100644 index 0000000000..c14ad9836f --- /dev/null +++ b/files/fr/web/api/node/haschildnodes/index.md @@ -0,0 +1,78 @@ +--- +title: element.hasChildNodes +slug: Web/API/Node/hasChildNodes +tags: + - API + - DOM + - Method + - NeedsSpecTable + - Node + - Reference +translation_of: Web/API/Node/hasChildNodes +--- +

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

+ +

Syntaxe

+ +
bool = node.hasChildNodes();
+ +

Valeur de retour

+ +

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

+ +

Exemple

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

Prothèse d'émulation

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

+ + + +

Spécification

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

Compatibilité des navigateurs

+ +

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

+ +

Voir aussi

+ + diff --git a/files/fr/web/api/node/index.html b/files/fr/web/api/node/index.html deleted file mode 100644 index 4c7ddde36b..0000000000 --- a/files/fr/web/api/node/index.html +++ /dev/null @@ -1,306 +0,0 @@ ---- -title: Node -slug: Web/API/Node -tags: - - API - - DOM - - Document - - Element - - Interface - - Node - - Référence DOM - - Structure - - 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) {
-  if (oParent.hasChildNodes()) {
-    for (var oNode = oParent.firstChild; oNode; oNode = oNode.nextSibling) {
-      DOMComb(oNode, oCallback);
-    }
-  }
-  oCallback.call(oParent);
-}
- -

Syntaxe

- -
DOMComb(parentNode, callbackFunction);
- -

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.

- -

Paramètres

- -
-
parentNode
-
Le nœud parent (Node Object)
-
callbackFunction
-
La fonction de rappel (Function).
-
- -

Exemples d'utilisation

- -

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

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

- -
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 diff --git a/files/fr/web/api/node/index.md b/files/fr/web/api/node/index.md new file mode 100644 index 0000000000..4c7ddde36b --- /dev/null +++ b/files/fr/web/api/node/index.md @@ -0,0 +1,306 @@ +--- +title: Node +slug: Web/API/Node +tags: + - API + - DOM + - Document + - Element + - Interface + - Node + - Référence DOM + - Structure + - 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) {
+  if (oParent.hasChildNodes()) {
+    for (var oNode = oParent.firstChild; oNode; oNode = oNode.nextSibling) {
+      DOMComb(oNode, oCallback);
+    }
+  }
+  oCallback.call(oParent);
+}
+ +

Syntaxe

+ +
DOMComb(parentNode, callbackFunction);
+ +

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.

+ +

Paramètres

+ +
+
parentNode
+
Le nœud parent (Node Object)
+
callbackFunction
+
La fonction de rappel (Function).
+
+ +

Exemples d'utilisation

+ +

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

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

+ +
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 diff --git a/files/fr/web/api/node/insertbefore/index.html b/files/fr/web/api/node/insertbefore/index.html deleted file mode 100644 index 289539552f..0000000000 --- a/files/fr/web/api/node/insertbefore/index.html +++ /dev/null @@ -1,166 +0,0 @@ ---- -title: element.insertBefore -slug: Web/API/Node/insertBefore -tags: - - API - - DOM - - Enfant - - Insertion - - Méthodes - - Noeud -translation_of: Web/API/Node/insertBefore ---- -

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

- -

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.

- -

Syntaxe

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

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.

-
- -

Valeur de retour

- -

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

- -

Exemples

- -

Exemple 1

- -
<div id="parentElement">
-  <span id="childElement">foo bar</span>
-</div>
-
-<script>
-// Crée le nouveau nœud à insérer
-let newNode = document.createElement("span")
-
-// Obtient une référence au nœud parent
-let parentDiv = document.getElementById("childElement").parentNode
-
-// Commence le cas de test [ 1 ] : Existing childElement (tout fonctionne correctement)
-let sp2 = document.getElementById("childElement")
-parentDiv.insertBefore(newNode, sp2)
-// Fin du cas de test [ 1 ]
-
-// Commence le cas de test [ 2 ] : childElement est de Type undefined
-let sp2 = undefined // Noeud non existant de l'id "childElement".
-parentDiv.insertBefore(newNode, sp2) // Transfert dynamique implicite vers le type Node
-// Fin du cas de test [ 2 ]
-
-// Commence le cas de test [ 3 ] : childElement est de Type "undefined" ( string )
-let sp2 = "undefined" // Noeud non existant de l'id "childElement".
-parentDiv.insertBefore(newNode, sp2) // Génère "Erreur de type : Argument non valide".
-// Fin du cas de test [ 3 ]
-</script>
-
- -

Exemple 2

- -
<div id="parentElement">
-  <span id="childElement">foo bar</span>
-</div>
-
-<script>
-// Crée un nouvel élément simple de type <span>
-let sp1 = document.createElement("span")
-
-// Obtient l'élément de référence
-let sp2 = document.getElementById("childElement")
-// Get the parent element
-let parentDiv = sp2.parentNode
-
-// Insert le nouvel élément dans avant sp2
-parentDiv.insertBefore(sp1, sp2)
-</script>
-
- -

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

- -

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

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

- -

Exemple 3

- -

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

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

diff --git a/files/fr/web/api/node/insertbefore/index.md b/files/fr/web/api/node/insertbefore/index.md new file mode 100644 index 0000000000..289539552f --- /dev/null +++ b/files/fr/web/api/node/insertbefore/index.md @@ -0,0 +1,166 @@ +--- +title: element.insertBefore +slug: Web/API/Node/insertBefore +tags: + - API + - DOM + - Enfant + - Insertion + - Méthodes + - Noeud +translation_of: Web/API/Node/insertBefore +--- +

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

+ +

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.

+ +

Syntaxe

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

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.

+
+ +

Valeur de retour

+ +

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

+ +

Exemples

+ +

Exemple 1

+ +
<div id="parentElement">
+  <span id="childElement">foo bar</span>
+</div>
+
+<script>
+// Crée le nouveau nœud à insérer
+let newNode = document.createElement("span")
+
+// Obtient une référence au nœud parent
+let parentDiv = document.getElementById("childElement").parentNode
+
+// Commence le cas de test [ 1 ] : Existing childElement (tout fonctionne correctement)
+let sp2 = document.getElementById("childElement")
+parentDiv.insertBefore(newNode, sp2)
+// Fin du cas de test [ 1 ]
+
+// Commence le cas de test [ 2 ] : childElement est de Type undefined
+let sp2 = undefined // Noeud non existant de l'id "childElement".
+parentDiv.insertBefore(newNode, sp2) // Transfert dynamique implicite vers le type Node
+// Fin du cas de test [ 2 ]
+
+// Commence le cas de test [ 3 ] : childElement est de Type "undefined" ( string )
+let sp2 = "undefined" // Noeud non existant de l'id "childElement".
+parentDiv.insertBefore(newNode, sp2) // Génère "Erreur de type : Argument non valide".
+// Fin du cas de test [ 3 ]
+</script>
+
+ +

Exemple 2

+ +
<div id="parentElement">
+  <span id="childElement">foo bar</span>
+</div>
+
+<script>
+// Crée un nouvel élément simple de type <span>
+let sp1 = document.createElement("span")
+
+// Obtient l'élément de référence
+let sp2 = document.getElementById("childElement")
+// Get the parent element
+let parentDiv = sp2.parentNode
+
+// Insert le nouvel élément dans avant sp2
+parentDiv.insertBefore(sp1, sp2)
+</script>
+
+ +

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

+ +

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

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

+ +

Exemple 3

+ +

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

+ +
// 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")}}

diff --git a/files/fr/web/api/node/isconnected/index.html b/files/fr/web/api/node/isconnected/index.html deleted file mode 100644 index 730afa1beb..0000000000 --- a/files/fr/web/api/node/isconnected/index.html +++ /dev/null @@ -1,96 +0,0 @@ ---- -title: Node.isConnected -slug: Web/API/Node/isConnected -tags: - - API - - DOM - - Noeuds - - Propriétés -translation_of: Web/API/Node/isConnected ---- -

 

- -

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

- -

Syntaxe

- -
var isItConnected = nodeObjectInstance.isConnected
- -

Renvoie la valeur

- -

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

- -

Exemples

- -

Un exemple DOM standard :

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

Un exemple DOM shadow :

- -
// 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)
-
-style.textContent = '.wrapper {' +
-                       'position: relative;' +
-                    '}' +
-
-                     '.info {' +
-                        'font-size: 0.8rem;' +
-                        'width: 200px;' +
-                        'display: inline-block;' +
-                        'border: 1px solid black;' +
-                        'padding: 10px;' +
-                        'background: white;' +
-                        'border-radius: 10px;' +
-                        'opacity: 0;' +
-                        'transition: 0.6s all;' +
-                        'position: absolute;' +
-                        'bottom: 20px;' +
-                        'left: 10px;' +
-                        'z-index: 3;' +
-                      '}' +
-
-// attache l'élément de style créé au dom shadow
-
-shadow.appendChild(style);
-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

- -
-
- - -

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

-
-
diff --git a/files/fr/web/api/node/isconnected/index.md b/files/fr/web/api/node/isconnected/index.md new file mode 100644 index 0000000000..730afa1beb --- /dev/null +++ b/files/fr/web/api/node/isconnected/index.md @@ -0,0 +1,96 @@ +--- +title: Node.isConnected +slug: Web/API/Node/isConnected +tags: + - API + - DOM + - Noeuds + - Propriétés +translation_of: Web/API/Node/isConnected +--- +

 

+ +

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

+ +

Syntaxe

+ +
var isItConnected = nodeObjectInstance.isConnected
+ +

Renvoie la valeur

+ +

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

+ +

Exemples

+ +

Un exemple DOM standard :

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

Un exemple DOM shadow :

+ +
// 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)
+
+style.textContent = '.wrapper {' +
+                       'position: relative;' +
+                    '}' +
+
+                     '.info {' +
+                        'font-size: 0.8rem;' +
+                        'width: 200px;' +
+                        'display: inline-block;' +
+                        'border: 1px solid black;' +
+                        'padding: 10px;' +
+                        'background: white;' +
+                        'border-radius: 10px;' +
+                        'opacity: 0;' +
+                        'transition: 0.6s all;' +
+                        'position: absolute;' +
+                        'bottom: 20px;' +
+                        'left: 10px;' +
+                        'z-index: 3;' +
+                      '}' +
+
+// attache l'élément de style créé au dom shadow
+
+shadow.appendChild(style);
+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

+ +
+
+ + +

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

+
+
diff --git a/files/fr/web/api/node/isdefaultnamespace/index.html b/files/fr/web/api/node/isdefaultnamespace/index.html deleted file mode 100644 index 1ea4b789bf..0000000000 --- a/files/fr/web/api/node/isdefaultnamespace/index.html +++ /dev/null @@ -1,39 +0,0 @@ ---- -title: Node.isDefaultNamespace() -slug: Web/API/Node/isDefaultNamespace -tags: - - API - - DOM - - Méthodes - - Noeuds -translation_of: Web/API/Node/isDefaultNamespace ---- -
-
{{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.

- -

Syntaxe

- -
result = node.isDefaultNamespace(namespaceURI)
-
- - - -

Exemple

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

Spécification

- - diff --git a/files/fr/web/api/node/isdefaultnamespace/index.md b/files/fr/web/api/node/isdefaultnamespace/index.md new file mode 100644 index 0000000000..1ea4b789bf --- /dev/null +++ b/files/fr/web/api/node/isdefaultnamespace/index.md @@ -0,0 +1,39 @@ +--- +title: Node.isDefaultNamespace() +slug: Web/API/Node/isDefaultNamespace +tags: + - API + - DOM + - Méthodes + - Noeuds +translation_of: Web/API/Node/isDefaultNamespace +--- +
+
{{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.

+ +

Syntaxe

+ +
result = node.isDefaultNamespace(namespaceURI)
+
+ + + +

Exemple

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

Spécification

+ + diff --git a/files/fr/web/api/node/isequalnode/index.html b/files/fr/web/api/node/isequalnode/index.html deleted file mode 100644 index 79bcb16b17..0000000000 --- a/files/fr/web/api/node/isequalnode/index.html +++ /dev/null @@ -1,90 +0,0 @@ ---- -title: Node.isEqualNode() -slug: Web/API/Node/isEqualNode -tags: - - API - - Comparaison - - DOM - - Méthodes - - Noeuds -translation_of: Web/API/Node/isEqualNode ---- -
-
{{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.

- -

Syntaxe

- -
var isEqualNode = node.isEqualNode(otherNode);
-
- - - -

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.

- -

HTML

- -
<div>This is the first element.</div>
-<div>This is the second element.</div>
-<div>This is the first element.</div>
-
-<p id="output"></p>
- -

CSS

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

JavaScript

- -
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/>";
- -

Résultats

- -

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

- -

Spécifications

- - - - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('DOM WHATWG', '#dom-node-isequalnode', 'Node.isEqualNode')}}{{Spec2('DOM WHATWG')}} 
- -

Compatibilité des navigateurs

- -

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

- -

Voir aussi

- - diff --git a/files/fr/web/api/node/isequalnode/index.md b/files/fr/web/api/node/isequalnode/index.md new file mode 100644 index 0000000000..79bcb16b17 --- /dev/null +++ b/files/fr/web/api/node/isequalnode/index.md @@ -0,0 +1,90 @@ +--- +title: Node.isEqualNode() +slug: Web/API/Node/isEqualNode +tags: + - API + - Comparaison + - DOM + - Méthodes + - Noeuds +translation_of: Web/API/Node/isEqualNode +--- +
+
{{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.

+ +

Syntaxe

+ +
var isEqualNode = node.isEqualNode(otherNode);
+
+ + + +

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.

+ +

HTML

+ +
<div>This is the first element.</div>
+<div>This is the second element.</div>
+<div>This is the first element.</div>
+
+<p id="output"></p>
+ +

CSS

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

JavaScript

+ +
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/>";
+ +

Résultats

+ +

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

+ +

Spécifications

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

Compatibilité des navigateurs

+ +

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

+ +

Voir aussi

+ + diff --git a/files/fr/web/api/node/issamenode/index.html b/files/fr/web/api/node/issamenode/index.html deleted file mode 100644 index cab5401b56..0000000000 --- a/files/fr/web/api/node/issamenode/index.html +++ /dev/null @@ -1,93 +0,0 @@ ---- -title: Node.isSameNode() -slug: Web/API/Node/isSameNode -tags: - - API - - DOM - - Méthodes - - Noeuds -translation_of: Web/API/Node/isSameNode ---- -
{{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.

- -

Syntaxe

- -
var isSameNode = node.isSameNode(other);
-
- -

Paramètres

- - - -

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.

- -

HTML

- -
<div>This is the first element.</div>
-<div>This is the second element.</div>
-<div>This is the first element.</div>
-
-<p id="output"></p>
- - - -

JavaScript

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

- - diff --git a/files/fr/web/api/node/issamenode/index.md b/files/fr/web/api/node/issamenode/index.md new file mode 100644 index 0000000000..cab5401b56 --- /dev/null +++ b/files/fr/web/api/node/issamenode/index.md @@ -0,0 +1,93 @@ +--- +title: Node.isSameNode() +slug: Web/API/Node/isSameNode +tags: + - API + - DOM + - Méthodes + - Noeuds +translation_of: Web/API/Node/isSameNode +--- +
{{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.

+ +

Syntaxe

+ +
var isSameNode = node.isSameNode(other);
+
+ +

Paramètres

+ + + +

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.

+ +

HTML

+ +
<div>This is the first element.</div>
+<div>This is the second element.</div>
+<div>This is the first element.</div>
+
+<p id="output"></p>
+ + + +

JavaScript

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

+ + diff --git a/files/fr/web/api/node/issupported/index.html b/files/fr/web/api/node/issupported/index.html deleted file mode 100644 index 3c241d4656..0000000000 --- a/files/fr/web/api/node/issupported/index.html +++ /dev/null @@ -1,78 +0,0 @@ ---- -title: element.isSupported -slug: Web/API/Node/isSupported -tags: - - API - - DOM - - Méthodes - - Noeuds -translation_of: Web/API/Node/isSupported ---- -

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

- -

Syntaxe

- -
boolValue = element.isSupported(feature, version)
- -

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

Exemple

- -
<div id="doc">
-</div>
-
-<script>
- // Obtenir un élément et vérifier pour voir s'il est pris en charge par les modules HTML DOM2.
- var main = document.getElementById('doc');
- var output = main.isSupported('HTML', '2.0');
-</script>
- -

Spécifications

- -

 

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

- - diff --git a/files/fr/web/api/node/issupported/index.md b/files/fr/web/api/node/issupported/index.md new file mode 100644 index 0000000000..3c241d4656 --- /dev/null +++ b/files/fr/web/api/node/issupported/index.md @@ -0,0 +1,78 @@ +--- +title: element.isSupported +slug: Web/API/Node/isSupported +tags: + - API + - DOM + - Méthodes + - Noeuds +translation_of: Web/API/Node/isSupported +--- +

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

+ +

Syntaxe

+ +
boolValue = element.isSupported(feature, version)
+ +

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

Exemple

+ +
<div id="doc">
+</div>
+
+<script>
+ // Obtenir un élément et vérifier pour voir s'il est pris en charge par les modules HTML DOM2.
+ var main = document.getElementById('doc');
+ var output = main.isSupported('HTML', '2.0');
+</script>
+ +

Spécifications

+ +

 

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

+ + diff --git a/files/fr/web/api/node/lastchild/index.html b/files/fr/web/api/node/lastchild/index.html deleted file mode 100644 index 37963f8473..0000000000 --- a/files/fr/web/api/node/lastchild/index.html +++ /dev/null @@ -1,66 +0,0 @@ ---- -title: element.lastChild -slug: Web/API/Node/lastChild -tags: - - API - - DOM - - Enfant - - Noeuds - - Propriétés -translation_of: Web/API/Node/lastChild ---- -

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

- -

Syntaxe

- -
var childNode = node.lastChild;
-
- -

 

- -

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

Compatibilité des navigateurs

- -

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

\ No newline at end of file diff --git a/files/fr/web/api/node/lastchild/index.md b/files/fr/web/api/node/lastchild/index.md new file mode 100644 index 0000000000..37963f8473 --- /dev/null +++ b/files/fr/web/api/node/lastchild/index.md @@ -0,0 +1,66 @@ +--- +title: element.lastChild +slug: Web/API/Node/lastChild +tags: + - API + - DOM + - Enfant + - Noeuds + - Propriétés +translation_of: Web/API/Node/lastChild +--- +

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

+ +

Syntaxe

+ +
var childNode = node.lastChild;
+
+ +

 

+ +

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

Compatibilité des navigateurs

+ +

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

\ No newline at end of file diff --git a/files/fr/web/api/node/lookupnamespaceuri/index.html b/files/fr/web/api/node/lookupnamespaceuri/index.html deleted file mode 100644 index 1c88e6b8a2..0000000000 --- a/files/fr/web/api/node/lookupnamespaceuri/index.html +++ /dev/null @@ -1,23 +0,0 @@ ---- -title: Node.lookupNamespaceURI() -slug: Web/API/Node/lookupNamespaceURI -tags: - - API - - DOM - - Méthodes - - Noeuds -translation_of: Web/API/Node/lookupNamespaceURI ---- -
{{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.

- -

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

- -

Voir aussi

- - - -

 

diff --git a/files/fr/web/api/node/lookupnamespaceuri/index.md b/files/fr/web/api/node/lookupnamespaceuri/index.md new file mode 100644 index 0000000000..1c88e6b8a2 --- /dev/null +++ b/files/fr/web/api/node/lookupnamespaceuri/index.md @@ -0,0 +1,23 @@ +--- +title: Node.lookupNamespaceURI() +slug: Web/API/Node/lookupNamespaceURI +tags: + - API + - DOM + - Méthodes + - Noeuds +translation_of: Web/API/Node/lookupNamespaceURI +--- +
{{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.

+ +

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

+ +

Voir aussi

+ + + +

 

diff --git a/files/fr/web/api/node/lookupprefix/index.html b/files/fr/web/api/node/lookupprefix/index.html deleted file mode 100644 index 17cc48c622..0000000000 --- a/files/fr/web/api/node/lookupprefix/index.html +++ /dev/null @@ -1,23 +0,0 @@ ---- -title: Node.lookupPrefix() -slug: Web/API/Node/lookupPrefix -tags: - - API - - DOM - - Méthodes - - Noeuds - - Préfixes - - URI -translation_of: Web/API/Node/lookupPrefix ---- -
{{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.

- -

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

- -

Voir aussi

- - diff --git a/files/fr/web/api/node/lookupprefix/index.md b/files/fr/web/api/node/lookupprefix/index.md new file mode 100644 index 0000000000..17cc48c622 --- /dev/null +++ b/files/fr/web/api/node/lookupprefix/index.md @@ -0,0 +1,23 @@ +--- +title: Node.lookupPrefix() +slug: Web/API/Node/lookupPrefix +tags: + - API + - DOM + - Méthodes + - Noeuds + - Préfixes + - URI +translation_of: Web/API/Node/lookupPrefix +--- +
{{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.

+ +

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

+ +

Voir aussi

+ + diff --git a/files/fr/web/api/node/nextsibling/index.html b/files/fr/web/api/node/nextsibling/index.html deleted file mode 100644 index 2a971a3067..0000000000 --- a/files/fr/web/api/node/nextsibling/index.html +++ /dev/null @@ -1,83 +0,0 @@ ---- -title: element.nextSibling -slug: Web/API/Node/nextSibling -tags: - - API - - DOM - - Noeuds - - Propriétés -translation_of: Web/API/Node/nextSibling ---- -

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

- -

Syntaxe

- -
nextNode = node.nextSibling
-
- -

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.

- -

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.

- -

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

- -

Exemple

- -
<div id="div-01">Here is div-01</div>
-<div id="div-02">Here is div-02</div>
-
-<script type="text/javascript">
-var el = document.getElementById('div-01').nextSibling,
-    i = 1;
-
-console.log('Siblings of div-01:');
-
-while (el) {
-  console.log(i + '. ' + el.nodeName);
-  el = el.nextSibling;
-  i++;
-}
-
-</script>
-
-/**************************************************
-  Ce qui suit est écrit sur la console pendant le chargement:
-
-     Siblings of div-01
-
-      1. #text
-      2. DIV
-      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 .

- -

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

- - - -

Compatibilité des navigateurs

- - - -

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

- -

Voir aussi

- -

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

diff --git a/files/fr/web/api/node/nextsibling/index.md b/files/fr/web/api/node/nextsibling/index.md new file mode 100644 index 0000000000..2a971a3067 --- /dev/null +++ b/files/fr/web/api/node/nextsibling/index.md @@ -0,0 +1,83 @@ +--- +title: element.nextSibling +slug: Web/API/Node/nextSibling +tags: + - API + - DOM + - Noeuds + - Propriétés +translation_of: Web/API/Node/nextSibling +--- +

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

+ +

Syntaxe

+ +
nextNode = node.nextSibling
+
+ +

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.

+ +

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.

+ +

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

+ +

Exemple

+ +
<div id="div-01">Here is div-01</div>
+<div id="div-02">Here is div-02</div>
+
+<script type="text/javascript">
+var el = document.getElementById('div-01').nextSibling,
+    i = 1;
+
+console.log('Siblings of div-01:');
+
+while (el) {
+  console.log(i + '. ' + el.nodeName);
+  el = el.nextSibling;
+  i++;
+}
+
+</script>
+
+/**************************************************
+  Ce qui suit est écrit sur la console pendant le chargement:
+
+     Siblings of div-01
+
+      1. #text
+      2. DIV
+      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 .

+ +

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

+ + + +

Compatibilité des navigateurs

+ + + +

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

+ +

Voir aussi

+ +

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

diff --git a/files/fr/web/api/node/nodename/index.html b/files/fr/web/api/node/nodename/index.html deleted file mode 100644 index 11c471fff1..0000000000 --- a/files/fr/web/api/node/nodename/index.html +++ /dev/null @@ -1,111 +0,0 @@ ---- -title: element.nodeName -slug: Web/API/Node/nodeName -tags: - - API - - DOM - - Noeuds - - Nom - - 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")}}

diff --git a/files/fr/web/api/node/nodename/index.md b/files/fr/web/api/node/nodename/index.md new file mode 100644 index 0000000000..11c471fff1 --- /dev/null +++ b/files/fr/web/api/node/nodename/index.md @@ -0,0 +1,111 @@ +--- +title: element.nodeName +slug: Web/API/Node/nodeName +tags: + - API + - DOM + - Noeuds + - Nom + - 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")}}

diff --git a/files/fr/web/api/node/nodetype/index.html b/files/fr/web/api/node/nodetype/index.html deleted file mode 100644 index 2f6cd30d79..0000000000 --- a/files/fr/web/api/node/nodetype/index.html +++ /dev/null @@ -1,180 +0,0 @@ ---- -title: element.nodeType -slug: Web/API/Node/nodeType -tags: - - API - - DOM - - Noeuds - - Propriétés - - Types -translation_of: Web/API/Node/nodeType ---- -
{{APIRef("DOM")}}
- -
La propriété en lecture seule Node.nodeType représente le type du noeud.
- -

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

- -

Syntaxe

- -
Type = node .nodeType
-
- -

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

- -

Constantes

- -

Constantes de type nœud

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
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()}}

- -

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

Exemples

- -

Différents types de noeuds

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

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.

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

Compatibilité des navigateurs

- - - -

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

diff --git a/files/fr/web/api/node/nodetype/index.md b/files/fr/web/api/node/nodetype/index.md new file mode 100644 index 0000000000..2f6cd30d79 --- /dev/null +++ b/files/fr/web/api/node/nodetype/index.md @@ -0,0 +1,180 @@ +--- +title: element.nodeType +slug: Web/API/Node/nodeType +tags: + - API + - DOM + - Noeuds + - Propriétés + - Types +translation_of: Web/API/Node/nodeType +--- +
{{APIRef("DOM")}}
+ +
La propriété en lecture seule Node.nodeType représente le type du noeud.
+ +

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

+ +

Syntaxe

+ +
Type = node .nodeType
+
+ +

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

+ +

Constantes

+ +

Constantes de type nœud

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

+ +

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

Exemples

+ +

Différents types de noeuds

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

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.

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

Compatibilité des navigateurs

+ + + +

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

diff --git a/files/fr/web/api/node/nodevalue/index.html b/files/fr/web/api/node/nodevalue/index.html deleted file mode 100644 index 9f3fa1f3b3..0000000000 --- a/files/fr/web/api/node/nodevalue/index.html +++ /dev/null @@ -1,93 +0,0 @@ ---- -title: element.nodeValue -slug: Web/API/Node/nodeValue -tags: - - API - - DOM - - Noeuds - - Propriétés -translation_of: Web/API/Node/nodeValue ---- -

{{APIRef("DOM")}}

- -

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

- -

Syntaxe

- -
value = node.nodeValue;
-
- -

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

- -

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.

- -

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

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

- -

Spécification

- - - -

Compatibilité des navigateurs

- - - -

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

diff --git a/files/fr/web/api/node/nodevalue/index.md b/files/fr/web/api/node/nodevalue/index.md new file mode 100644 index 0000000000..9f3fa1f3b3 --- /dev/null +++ b/files/fr/web/api/node/nodevalue/index.md @@ -0,0 +1,93 @@ +--- +title: element.nodeValue +slug: Web/API/Node/nodeValue +tags: + - API + - DOM + - Noeuds + - Propriétés +translation_of: Web/API/Node/nodeValue +--- +

{{APIRef("DOM")}}

+ +

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

+ +

Syntaxe

+ +
value = node.nodeValue;
+
+ +

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

+ +

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.

+ +

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

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

+ +

Spécification

+ + + +

Compatibilité des navigateurs

+ + + +

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

diff --git a/files/fr/web/api/node/normalize/index.html b/files/fr/web/api/node/normalize/index.html deleted file mode 100644 index c1a299fb15..0000000000 --- a/files/fr/web/api/node/normalize/index.html +++ /dev/null @@ -1,38 +0,0 @@ ---- -title: element.normalize -slug: Web/API/Node/normalize -translation_of: Web/API/Node/normalize ---- -

{{ ApiRef("DOM") }}

- -

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.

- -

Syntaxe

- -
élément.normalize();
-
- -

Exemple

- -
var conteneur = document.createElement("div");
-conteneur.appendChild( document.createTextNode("Partie 1 ") );
-conteneu.appendChild( document.createTextNode("Partie 2 ") );
-
-// Ici, conteneur.childNodes.length === 2
-// conteneur.childNodes[0].textContent === "Partie 1 "
-// conteneur.childNodes[1].textContent === "Partie 2 "
-
-conteneur.normalize();
-
-// À présent, conteneur.childNodes.length === 1
-// conteneur.childNodes[0].textContent === "Partie 1 Partie 2 "
- -

Notes

- -

Spécification

- - \ No newline at end of file diff --git a/files/fr/web/api/node/normalize/index.md b/files/fr/web/api/node/normalize/index.md new file mode 100644 index 0000000000..c1a299fb15 --- /dev/null +++ b/files/fr/web/api/node/normalize/index.md @@ -0,0 +1,38 @@ +--- +title: element.normalize +slug: Web/API/Node/normalize +translation_of: Web/API/Node/normalize +--- +

{{ ApiRef("DOM") }}

+ +

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.

+ +

Syntaxe

+ +
élément.normalize();
+
+ +

Exemple

+ +
var conteneur = document.createElement("div");
+conteneur.appendChild( document.createTextNode("Partie 1 ") );
+conteneu.appendChild( document.createTextNode("Partie 2 ") );
+
+// Ici, conteneur.childNodes.length === 2
+// conteneur.childNodes[0].textContent === "Partie 1 "
+// conteneur.childNodes[1].textContent === "Partie 2 "
+
+conteneur.normalize();
+
+// À présent, conteneur.childNodes.length === 1
+// conteneur.childNodes[0].textContent === "Partie 1 Partie 2 "
+ +

Notes

+ +

Spécification

+ + \ No newline at end of file diff --git a/files/fr/web/api/node/ownerdocument/index.html b/files/fr/web/api/node/ownerdocument/index.html deleted file mode 100644 index 35b5eb6859..0000000000 --- a/files/fr/web/api/node/ownerdocument/index.html +++ /dev/null @@ -1,66 +0,0 @@ ---- -title: element.ownerDocument -slug: Web/API/Node/ownerDocument -tags: - - API - - DOM - - Document - - Noeuds - - Propriétés -translation_of: Web/API/Node/ownerDocument ---- -

{{APIRef("DOM")}}

- -

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

- -

Syntaxe

- -
document = element.ownerDocument;
-
- - - -

Exemple

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

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.

- -

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

Compatibilité des navigateurs

- -

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

\ No newline at end of file diff --git a/files/fr/web/api/node/ownerdocument/index.md b/files/fr/web/api/node/ownerdocument/index.md new file mode 100644 index 0000000000..35b5eb6859 --- /dev/null +++ b/files/fr/web/api/node/ownerdocument/index.md @@ -0,0 +1,66 @@ +--- +title: element.ownerDocument +slug: Web/API/Node/ownerDocument +tags: + - API + - DOM + - Document + - Noeuds + - Propriétés +translation_of: Web/API/Node/ownerDocument +--- +

{{APIRef("DOM")}}

+ +

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

+ +

Syntaxe

+ +
document = element.ownerDocument;
+
+ + + +

Exemple

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

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.

+ +

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

Compatibilité des navigateurs

+ +

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

\ No newline at end of file diff --git a/files/fr/web/api/node/parentelement/index.html b/files/fr/web/api/node/parentelement/index.html deleted file mode 100644 index 673cb3b8b2..0000000000 --- a/files/fr/web/api/node/parentelement/index.html +++ /dev/null @@ -1,53 +0,0 @@ ---- -title: Node.parentElement -slug: Web/API/Node/parentElement -tags: - - API - - DOM - - Noeuds - - Propriétés - - parent -translation_of: Web/API/Node/parentElement ---- -
-
-
{{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.
-
- -

Syntaxe

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

- -

Exemple

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

- -
- - -

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

-
- -

Spécifications

- - - -

Voir aussi

- - diff --git a/files/fr/web/api/node/parentelement/index.md b/files/fr/web/api/node/parentelement/index.md new file mode 100644 index 0000000000..673cb3b8b2 --- /dev/null +++ b/files/fr/web/api/node/parentelement/index.md @@ -0,0 +1,53 @@ +--- +title: Node.parentElement +slug: Web/API/Node/parentElement +tags: + - API + - DOM + - Noeuds + - Propriétés + - parent +translation_of: Web/API/Node/parentElement +--- +
+
+
{{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.
+
+ +

Syntaxe

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

+ +

Exemple

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

+ +
+ + +

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

+
+ +

Spécifications

+ + + +

Voir aussi

+ + diff --git a/files/fr/web/api/node/parentnode/index.html b/files/fr/web/api/node/parentnode/index.html deleted file mode 100644 index 5d2088cbf6..0000000000 --- a/files/fr/web/api/node/parentnode/index.html +++ /dev/null @@ -1,58 +0,0 @@ ---- -title: element.parentNode -slug: Web/API/Node/parentNode -tags: - - API - - DOM - - Noeuds - - Propriétés - - parent -translation_of: Web/API/Node/parentNode ---- -

{{APIRef("DOM")}}

- -

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

- -

Syntaxe

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

- -

Exemple

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

Notes

- -

Les noeuds 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.

- -

Compatibilité des navigateurs

- -

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

- -

Spécification

- - - - -

Voir aussi

- - \ No newline at end of file diff --git a/files/fr/web/api/node/parentnode/index.md b/files/fr/web/api/node/parentnode/index.md new file mode 100644 index 0000000000..5d2088cbf6 --- /dev/null +++ b/files/fr/web/api/node/parentnode/index.md @@ -0,0 +1,58 @@ +--- +title: element.parentNode +slug: Web/API/Node/parentNode +tags: + - API + - DOM + - Noeuds + - Propriétés + - parent +translation_of: Web/API/Node/parentNode +--- +

{{APIRef("DOM")}}

+ +

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

+ +

Syntaxe

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

+ +

Exemple

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

Notes

+ +

Les noeuds 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.

+ +

Compatibilité des navigateurs

+ +

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

+ +

Spécification

+ + + + +

Voir aussi

+ + \ No newline at end of file diff --git a/files/fr/web/api/node/previoussibling/index.html b/files/fr/web/api/node/previoussibling/index.html deleted file mode 100644 index 31e02f5c7a..0000000000 --- a/files/fr/web/api/node/previoussibling/index.html +++ /dev/null @@ -1,56 +0,0 @@ ---- -title: element.previousSibling -slug: Web/API/Node/previousSibling -tags: - - API - - DOM - - Noeuds - - Propriétés -translation_of: Web/API/Node/previousSibling ---- -

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

- -

Syntaxe

- -
previousNode = node.previousSibling;
-
- -

Exemple

- -
// <a><b1 id="b1"/><b2 id="b2"/></a>
-
-alert(document.getElementById("b1").previousSibling); // null
-alert(document.getElementById("b2").previousSibling.id); // "b1"
- -

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.

- -

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.

- -

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

- -

Spécifications

- - - -

Compatibilité des navigateurs

- - - -

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

- -

Voir aussi

- -

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

diff --git a/files/fr/web/api/node/previoussibling/index.md b/files/fr/web/api/node/previoussibling/index.md new file mode 100644 index 0000000000..31e02f5c7a --- /dev/null +++ b/files/fr/web/api/node/previoussibling/index.md @@ -0,0 +1,56 @@ +--- +title: element.previousSibling +slug: Web/API/Node/previousSibling +tags: + - API + - DOM + - Noeuds + - Propriétés +translation_of: Web/API/Node/previousSibling +--- +

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

+ +

Syntaxe

+ +
previousNode = node.previousSibling;
+
+ +

Exemple

+ +
// <a><b1 id="b1"/><b2 id="b2"/></a>
+
+alert(document.getElementById("b1").previousSibling); // null
+alert(document.getElementById("b2").previousSibling.id); // "b1"
+ +

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.

+ +

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.

+ +

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

+ +

Spécifications

+ + + +

Compatibilité des navigateurs

+ + + +

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

+ +

Voir aussi

+ +

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

diff --git a/files/fr/web/api/node/removechild/index.html b/files/fr/web/api/node/removechild/index.html deleted file mode 100644 index 051a65c4e6..0000000000 --- a/files/fr/web/api/node/removechild/index.html +++ /dev/null @@ -1,112 +0,0 @@ ---- -title: element.removeChild -slug: Web/API/Node/removeChild -tags: - - API - - DOM - - Enfant - - Méthodes - - Noeuds - - Suppression -translation_of: Web/API/Node/removeChild ---- -

{{ ApiRef("DOM") }}

- -

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

- -

Syntaxe

- -
var oldChild = node.removeChild(child);
-OR
-node.removeChild(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. 

- -

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.

- -

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 :

- -
    -
  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. -
  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'.
    3. -
- -

Exemples

- -
<!--Sample HTML code-->
-<div id="top" align="center"> </div>
-
-<script type="text/javascript">
-      var top = document.getElementById("top");
-      var nested = document.getElementById("nested");
-
-      var garbage = top.removeChild(nested);    //Cas test 2: la méthode lance l'exception (2)
-
-</script>
-
-<!--Sample HTML code-->
-<div id="top" align="center">
- <div id="nested"></div>
-</div>
-
-<script type="text/javascript">
-      var top = document.getElementById("top");
-      var nested = document.getElementById("nested");
-
-      var garbage = top.removeChild(nested); // Ce premier appel supprime correctement le noeud
-
-      // ......
-      garbage = top.removeChild(nested);   // Cas test 1 : la méthode dans le second appel ici, lance l'exception (1)
-
-</script>
- -
<!--Sample HTML code-->
-
-<div id="top" align="center">
-  <div id="nested"></div>
-</div>
- -
// 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);
- -
// 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);
-}
- -
-// Supprime tous les enfant d'un élément
-var element = document.getElementById("top");
-while (element.firstChild) {
-  element.removeChild(element.firstChild);
-}
- -

Spécifications

- - - -

Voir aussi

- - diff --git a/files/fr/web/api/node/removechild/index.md b/files/fr/web/api/node/removechild/index.md new file mode 100644 index 0000000000..051a65c4e6 --- /dev/null +++ b/files/fr/web/api/node/removechild/index.md @@ -0,0 +1,112 @@ +--- +title: element.removeChild +slug: Web/API/Node/removeChild +tags: + - API + - DOM + - Enfant + - Méthodes + - Noeuds + - Suppression +translation_of: Web/API/Node/removeChild +--- +

{{ ApiRef("DOM") }}

+ +

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

+ +

Syntaxe

+ +
var oldChild = node.removeChild(child);
+OR
+node.removeChild(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. 

+ +

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.

+ +

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 :

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

Exemples

+ +
<!--Sample HTML code-->
+<div id="top" align="center"> </div>
+
+<script type="text/javascript">
+      var top = document.getElementById("top");
+      var nested = document.getElementById("nested");
+
+      var garbage = top.removeChild(nested);    //Cas test 2: la méthode lance l'exception (2)
+
+</script>
+
+<!--Sample HTML code-->
+<div id="top" align="center">
+ <div id="nested"></div>
+</div>
+
+<script type="text/javascript">
+      var top = document.getElementById("top");
+      var nested = document.getElementById("nested");
+
+      var garbage = top.removeChild(nested); // Ce premier appel supprime correctement le noeud
+
+      // ......
+      garbage = top.removeChild(nested);   // Cas test 1 : la méthode dans le second appel ici, lance l'exception (1)
+
+</script>
+ +
<!--Sample HTML code-->
+
+<div id="top" align="center">
+  <div id="nested"></div>
+</div>
+ +
// 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);
+ +
// 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);
+}
+ +
+// Supprime tous les enfant d'un élément
+var element = document.getElementById("top");
+while (element.firstChild) {
+  element.removeChild(element.firstChild);
+}
+ +

Spécifications

+ + + +

Voir aussi

+ + diff --git a/files/fr/web/api/node/replacechild/index.html b/files/fr/web/api/node/replacechild/index.html deleted file mode 100644 index 3cdf5aa950..0000000000 --- a/files/fr/web/api/node/replacechild/index.html +++ /dev/null @@ -1,90 +0,0 @@ ---- -title: element.replaceChild -slug: Web/API/Node/replaceChild -tags: - - API - - DOM - - Enfant - - Méthodes - - Noeuds - - Remplacement -translation_of: Web/API/Node/replaceChild ---- -

{{APIRef("DOM")}}

- -

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

- -

Syntaxe

- -
replacedNode = parentNode.replaceChild(newChild, oldChild);
-
- - - -

Exemple

- -
// Étant donné que :
-// <div>
-//   <span id="childSpan">foo bar</span>
-// </div>
-
-// Crée un nœud d'élément vide
-// sans ID, sans attributs et sans contenu
-var sp1 = document.createElement("span");
-
-// Donne un attribut id appelé "newSpan"
-sp1.id = "newSpan";
-
-// Crée du contenu pour le nouvel élément
-var sp1_content = document.createTextNode("nouvel élément span de remplacement.");
-
-// Applique ce contenu au nouvel élément
-sp1.appendChild(sp1_content);
-
-// Construit une référence au nœud existant à remplacer
-var sp2 = document.getElementById("childSpan");
-var parentDiv = sp2.parentNode;
-
-// Remplacer le noeud existant sp2 par le nouvel élément span sp1
-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

- - diff --git a/files/fr/web/api/node/replacechild/index.md b/files/fr/web/api/node/replacechild/index.md new file mode 100644 index 0000000000..3cdf5aa950 --- /dev/null +++ b/files/fr/web/api/node/replacechild/index.md @@ -0,0 +1,90 @@ +--- +title: element.replaceChild +slug: Web/API/Node/replaceChild +tags: + - API + - DOM + - Enfant + - Méthodes + - Noeuds + - Remplacement +translation_of: Web/API/Node/replaceChild +--- +

{{APIRef("DOM")}}

+ +

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

+ +

Syntaxe

+ +
replacedNode = parentNode.replaceChild(newChild, oldChild);
+
+ + + +

Exemple

+ +
// Étant donné que :
+// <div>
+//   <span id="childSpan">foo bar</span>
+// </div>
+
+// Crée un nœud d'élément vide
+// sans ID, sans attributs et sans contenu
+var sp1 = document.createElement("span");
+
+// Donne un attribut id appelé "newSpan"
+sp1.id = "newSpan";
+
+// Crée du contenu pour le nouvel élément
+var sp1_content = document.createTextNode("nouvel élément span de remplacement.");
+
+// Applique ce contenu au nouvel élément
+sp1.appendChild(sp1_content);
+
+// Construit une référence au nœud existant à remplacer
+var sp2 = document.getElementById("childSpan");
+var parentDiv = sp2.parentNode;
+
+// Remplacer le noeud existant sp2 par le nouvel élément span sp1
+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

+ + diff --git a/files/fr/web/api/node/textcontent/index.html b/files/fr/web/api/node/textcontent/index.html deleted file mode 100644 index 63e892d5b6..0000000000 --- a/files/fr/web/api/node/textcontent/index.html +++ /dev/null @@ -1,125 +0,0 @@ ---- -title: element.textContent -slug: Web/API/Node/textContent -tags: - - API - - DOM - - Noeuds - - Propriétés -translation_of: Web/API/Node/textContent ---- -

{{APIRef("DOM")}}

- -

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

- -

Syntaxe

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

Description

- - - -

Différences avec innerText

- -

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

- - - -

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.

- -

Exemple

- -
// Étant donné le fragment de HTML suivant :
-//   <div id="divA">Ceci est un <span>exemple de</span> texte</div>
-
-// 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>
-
- -

Polyfill pour IE8

- -
// 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) {
-  (function() {
-    var innerText = Object.getOwnPropertyDescriptor(Element.prototype, "innerText");
-    Object.defineProperty(Element.prototype, "textContent",
-     // Passing innerText or innerText.get directly does not work,
-     // wrapper function is required.
-     {
-       get: function() {
-         return innerText.get.call(this);
-       },
-       set: function(s) {
-         return innerText.set.call(this, s);
-       }
-     }
-   );
-  })();
-}
- - - -

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

- - - -

 

diff --git a/files/fr/web/api/node/textcontent/index.md b/files/fr/web/api/node/textcontent/index.md new file mode 100644 index 0000000000..63e892d5b6 --- /dev/null +++ b/files/fr/web/api/node/textcontent/index.md @@ -0,0 +1,125 @@ +--- +title: element.textContent +slug: Web/API/Node/textContent +tags: + - API + - DOM + - Noeuds + - Propriétés +translation_of: Web/API/Node/textContent +--- +

{{APIRef("DOM")}}

+ +

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

+ +

Syntaxe

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

Description

+ + + +

Différences avec innerText

+ +

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

+ + + +

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.

+ +

Exemple

+ +
// Étant donné le fragment de HTML suivant :
+//   <div id="divA">Ceci est un <span>exemple de</span> texte</div>
+
+// 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>
+
+ +

Polyfill pour IE8

+ +
// 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) {
+  (function() {
+    var innerText = Object.getOwnPropertyDescriptor(Element.prototype, "innerText");
+    Object.defineProperty(Element.prototype, "textContent",
+     // Passing innerText or innerText.get directly does not work,
+     // wrapper function is required.
+     {
+       get: function() {
+         return innerText.get.call(this);
+       },
+       set: function(s) {
+         return innerText.set.call(this, s);
+       }
+     }
+   );
+  })();
+}
+ + + +

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

+ + + +

 

-- cgit v1.2.3-54-g00ecf