From 6772831200d14c2436aea2d0c837f40dbf12156f Mon Sep 17 00:00:00 2001 From: SphinxKnight Date: Sun, 26 Sep 2021 13:11:47 +0200 Subject: Prepare Web API section for Markdown conversion (#2464) * Remove summary classes and ids * Remove unecessary hidden * Remove useless span filled with useless attributes / ids * Remove useless font * Remove notranslate * Remove id in other elements than headings * Remove name attributes * Remove
 for JS w/ language-js class

* Remove 
 for HTML w/ language-html class

* Remove 
 for other lang w/ language-* class

* Rm highlighted line in code samples

* fix links, internal, external, absolute URLs

* missing file from last commit

* Fix styles errors apart from table + some classes

* Fix notes and warnings (+ some other :x)

* fix typo during merge which broke a doc

* aand forgot a conflict

* fix remaining classes of errors except dls and images

* Fix dls

* Fix images (deki/mozillademos) and remaining style issues

* Remove script tag from svg file

* Remove script tag from svg fileS

* Compress SVG files for CI
---
 files/fr/web/api/node/appendchild/index.html       | 12 +--
 files/fr/web/api/node/baseuri/index.html           | 14 ++--
 files/fr/web/api/node/childnodes/index.html        | 36 ++++-----
 files/fr/web/api/node/clonenode/index.html         | 10 +--
 .../api/node/comparedocumentposition/index.html    | 12 +--
 files/fr/web/api/node/contains/index.html          |  4 +-
 files/fr/web/api/node/firstchild/index.html        | 12 +--
 files/fr/web/api/node/getrootnode/index.html       | 10 +--
 files/fr/web/api/node/haschildnodes/index.html     |  2 +-
 files/fr/web/api/node/index.html                   | 94 +++++++++++-----------
 files/fr/web/api/node/insertbefore/index.html      |  4 +-
 files/fr/web/api/node/isconnected/index.html       |  8 +-
 .../fr/web/api/node/isdefaultnamespace/index.html  |  8 +-
 files/fr/web/api/node/isequalnode/index.html       | 40 ++++-----
 files/fr/web/api/node/issamenode/index.html        |  6 +-
 files/fr/web/api/node/issupported/index.html       | 27 +++----
 files/fr/web/api/node/lastchild/index.html         | 14 ++--
 .../fr/web/api/node/lookupnamespaceuri/index.html  |  4 +-
 files/fr/web/api/node/lookupprefix/index.html      |  4 +-
 files/fr/web/api/node/nextsibling/index.html       | 46 +++++------
 files/fr/web/api/node/nodename/index.html          | 10 +--
 files/fr/web/api/node/nodetype/index.html          | 24 +++---
 files/fr/web/api/node/nodevalue/index.html         |  6 +-
 files/fr/web/api/node/normalize/index.html         | 14 ++--
 files/fr/web/api/node/ownerdocument/index.html     | 16 ++--
 files/fr/web/api/node/parentelement/index.html     | 16 ++--
 files/fr/web/api/node/parentnode/index.html        | 37 ++++-----
 files/fr/web/api/node/previoussibling/index.html   | 26 +++---
 files/fr/web/api/node/removechild/index.html       | 88 ++++++++++----------
 files/fr/web/api/node/replacechild/index.html      |  2 +-
 files/fr/web/api/node/textcontent/index.html       | 56 ++++++-------
 31 files changed, 313 insertions(+), 349 deletions(-)

(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
index 5f01da03c8..800be4c3bb 100644
--- a/files/fr/web/api/node/appendchild/index.html
+++ b/files/fr/web/api/node/appendchild/index.html
@@ -32,21 +32,21 @@ translation_of: Web/API/Node/appendChild
 
 

Valeur renvoyée

-

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

+

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

Notes

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'));
+
var aBlock = doc.createElement('block').appendChild(doc.createElement('b'));

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

-

Exemple

+

Exemple

-
// Crée un nouvel élément paragraphe et l'ajoute à la fin du corps du document
-var p = document.createElement("p");
-document.body.appendChild(p);
+
// 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

diff --git a/files/fr/web/api/node/baseuri/index.html b/files/fr/web/api/node/baseuri/index.html index cc52dd42cf..68cf5be1bc 100644 --- a/files/fr/web/api/node/baseuri/index.html +++ b/files/fr/web/api/node/baseuri/index.html @@ -18,11 +18,11 @@ translation_of: Web/API/Node/baseURI

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

-

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

+

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

-

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

+

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

-

Syntaxe

+

Syntaxe

var baseURI = node.baseURI;
 
@@ -33,7 +33,7 @@ translation_of: Web/API/Node/baseURI
  • node.baseURI peut changer avec le temps (voir ci-dessous).
  • -

    Détails

    +

    Détails

    L'URL de base d'un document

    @@ -52,11 +52,11 @@ translation_of: Web/API/Node/baseURI

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

    -

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

    +

    Si le document contient des attributs xml:base (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

    +

    Spécification

    • {{spec("http://www.w3.org/TR/DOM-Level-3-Core/core.html#Node3-baseURI","DOM Level 3 Core: baseURI","REC")}}
    • @@ -66,6 +66,6 @@ translation_of: Web/API/Node/baseURI
      • l'élément {{HTMLElement("base")}} (HTML)
      • -
      • l'attribut xml:base (documents XML).
      • +
      • l'attribut xml:base (documents XML).
      • {{domxref("Node.baseURIObject")}} - une variante de cette API pour les add-ons Mozilla et le code interne. Renvoie l'URL de base en tant que {{interface("nsIURI")}}.
      diff --git a/files/fr/web/api/node/childnodes/index.html b/files/fr/web/api/node/childnodes/index.html index af687c7c99..b9f4630ffc 100644 --- a/files/fr/web/api/node/childnodes/index.html +++ b/files/fr/web/api/node/childnodes/index.html @@ -13,42 +13,42 @@ translation_of: Web/API/Node/childNodes

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

      -

      Syntaxe

      +

      Syntaxe

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

      Exemples

      Utilisation simple

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

      +

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

      +

      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.

      diff --git a/files/fr/web/api/node/clonenode/index.html b/files/fr/web/api/node/clonenode/index.html index 7e342018f1..fef79935dc 100644 --- a/files/fr/web/api/node/clonenode/index.html +++ b/files/fr/web/api/node/clonenode/index.html @@ -13,7 +13,7 @@ translation_of: Web/API/Node/cloneNode

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

      -

      Syntaxe

      +

      Syntaxe

      var dupNode = node.cloneNode([deep]);
       
      @@ -33,15 +33,15 @@ translation_of: Web/API/Node/cloneNode

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

      -

      Exemple

      +

      Exemple

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

      Notes

      +

      Notes

      -

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

      +

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

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

      @@ -58,7 +58,7 @@ p_prime = p.cloneNode(true);

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

      -

      Spécification

      +

      Spécification

      diff --git a/files/fr/web/api/node/comparedocumentposition/index.html b/files/fr/web/api/node/comparedocumentposition/index.html index e5b81bcb4b..a40125b5c1 100644 --- a/files/fr/web/api/node/comparedocumentposition/index.html +++ b/files/fr/web/api/node/comparedocumentposition/index.html @@ -51,12 +51,12 @@ translation_of: Web/API/Node/compareDocumentPosition
      -

      Syntaxe

      +

      Syntaxe

      node.compareDocumentPosition( otherNode )
       
      -

      Exemple

      +

      Exemple

      var head = document.getElementsByTagName('head').item(0);
       
      @@ -68,16 +68,16 @@ if (head.compareDocumentPosition(document.body) & Node.DOCUMENT_POSITION_FOL
       
      -

      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 : 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écifications

      - +
      @@ -104,5 +104,5 @@ if (head.compareDocumentPosition(document.body) & Node.DOCUMENT_POSITION_FOL

      Voir aussi

      diff --git a/files/fr/web/api/node/contains/index.html b/files/fr/web/api/node/contains/index.html index 5b7f4c23e5..e5906fbf28 100644 --- a/files/fr/web/api/node/contains/index.html +++ b/files/fr/web/api/node/contains/index.html @@ -18,9 +18,9 @@ translation_of: Web/API/Node/contains
      node.contains( otherNode )
       
      -

      Exemple

      +

      Exemple

      -

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

      +

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

      function isInPage(node) {
         return (node === document.body) ? false : document.body.contains(node);
      diff --git a/files/fr/web/api/node/firstchild/index.html b/files/fr/web/api/node/firstchild/index.html
      index a9392e7650..3c846498af 100644
      --- a/files/fr/web/api/node/firstchild/index.html
      +++ b/files/fr/web/api/node/firstchild/index.html
      @@ -13,11 +13,11 @@ translation_of: Web/API/Node/firstChild
       
       

      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

      +

      Syntaxe

      var childNode = node.firstChild;
      -

      Exemple

      +

      Exemple

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

      @@ -31,7 +31,7 @@ translation_of: Web/API/Node/firstChild </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.

      +

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

      @@ -85,8 +85,4 @@ translation_of: Web/API/Node/firstChild

      Compatibilité des navigateurs

      - - -

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

      - -
       
      +

      {{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 index 277df08cd3..5a6297d55b 100644 --- a/files/fr/web/api/node/getrootnode/index.html +++ b/files/fr/web/api/node/getrootnode/index.html @@ -36,7 +36,7 @@ translation_of: Web/API/Node/getRootNode

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

      @@ -86,10 +86,4 @@ translation_of: Web/API/Node/getRootNode

      Compatibilité des navigateurs

      -
      - - -

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

      -
      - -
       
      +

      {{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 index d0af3b4b65..c14ad9836f 100644 --- a/files/fr/web/api/node/haschildnodes/index.html +++ b/files/fr/web/api/node/haschildnodes/index.html @@ -12,7 +12,7 @@ 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.

      +

      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

      diff --git a/files/fr/web/api/node/index.html b/files/fr/web/api/node/index.html index cdd9ff13a3..4c7ddde36b 100644 --- a/files/fr/web/api/node/index.html +++ b/files/fr/web/api/node/index.html @@ -25,13 +25,13 @@ translation_of: Web/API/Node

      Propriétés

      -

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

      +

      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 /.
      +
      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.
      +
      (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}}
      @@ -111,11 +111,11 @@ translation_of: Web/API/Node
      {{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.
      +
      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.
      +
      Retourne / définit le contenu textuel d'un élément et de tous ses descendants.
      @@ -125,11 +125,11 @@ translation_of: Web/API/Node
      {{DOMxRef("Node.localName")}} {{obsolete_inline}}{{readonlyInline}}
      -
      Retourne un {{domxref("DOMString")}}  représentant la partie locale du nom d'un élément.
      +
      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")}}

      +

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

      @@ -138,7 +138,7 @@ translation_of: Web/API/Node
      -

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

      +

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

      @@ -152,7 +152,7 @@ translation_of: Web/API/Node

      Méthodes

      -

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

      +

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

      {{DOMxRef("Node.appendChild()", "Node.appendChild(childNode)")}}
      @@ -163,15 +163,15 @@ translation_of: Web/API/Node
      {{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.
      +
      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.
      +
      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.
      +
      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.
      +
      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()")}}
      @@ -196,70 +196,70 @@ translation_of: Web/API/Node
      {{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.
      +
      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.
      +
      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.
      +
      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.
      +
      Permet à un utilisateur d'attacher ou d'enlever  {{domxref("DOMUserData")}} du nœud.

      Exemples

      -

      Parcourir tous les nœuds enfants

      +

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

      +

      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)
      +
      Le nœud parent (Node Object)
      callbackFunction
      -
      La fonction de rappel (Function).
      +
      La fonction de rappel (Function).

      Exemples d'utilisation

      -

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

      +

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

      -
      function printContent () {
      -  if (this.nodeValue) { console.log(this.nodeValue); }
      -}
      +
      function printContent () {
      +  if (this.nodeValue) { console.log(this.nodeValue); }
      +}
       
      -onload = function () {
      -  DOMComb(document.body, printContent);
      -};
      +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;
      -};
      +
      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();
      +
      /* ... an alternative to document.body.innerHTML = "" ... */
      +document.body.removeAll();

      Spécifications

      @@ -275,7 +275,7 @@ document.bodySupprime les propriétés suivantes : attributes, namespaceURI, prefix, et localName.
      +
      @@ -303,8 +303,4 @@ document.bodyCompatibilité des navigateurs - - -

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

      - -
      +

      {{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 index 780cf3bb18..289539552f 100644 --- a/files/fr/web/api/node/insertbefore/index.html +++ b/files/fr/web/api/node/insertbefore/index.html @@ -12,7 +12,7 @@ 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é.

      +

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

      @@ -94,7 +94,7 @@ 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.

      +

      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 :

      diff --git a/files/fr/web/api/node/isconnected/index.html b/files/fr/web/api/node/isconnected/index.html index 0e2acb7b5b..730afa1beb 100644 --- a/files/fr/web/api/node/isconnected/index.html +++ b/files/fr/web/api/node/isconnected/index.html @@ -20,16 +20,16 @@ translation_of: Web/API/Node/isConnected

      Renvoie la valeur

      -

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

      +

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

      Exemples

      Un exemple DOM standard :

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

      Un exemple DOM shadow :

      diff --git a/files/fr/web/api/node/isdefaultnamespace/index.html b/files/fr/web/api/node/isdefaultnamespace/index.html index 67da853471..1ea4b789bf 100644 --- a/files/fr/web/api/node/isdefaultnamespace/index.html +++ b/files/fr/web/api/node/isdefaultnamespace/index.html @@ -14,7 +14,7 @@ translation_of: Web/API/Node/isDefaultNamespace

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

      -

      Syntaxe

      +

      Syntaxe

      result = node.isDefaultNamespace(namespaceURI)
       
      @@ -24,16 +24,16 @@ translation_of: Web/API/Node/isDefaultNamespace
    • namespaceURI est une string (chaîne de caractères) représentant l'espace de nom par rapport auquel l'élément sera vérifié.
    • -

      Exemple

      +

      Exemple

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

      Spécification

      +

      Spécification

      diff --git a/files/fr/web/api/node/isequalnode/index.html b/files/fr/web/api/node/isequalnode/index.html index b6e3f84009..79bcb16b17 100644 --- a/files/fr/web/api/node/isequalnode/index.html +++ b/files/fr/web/api/node/isequalnode/index.html @@ -15,7 +15,7 @@ translation_of: Web/API/Node/isEqualNode

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

      -

      Syntaxe

      +

      Syntaxe

      var isEqualNode = node.isEqualNode(otherNode);
       
      @@ -30,37 +30,37 @@ translation_of: Web/API/Node/isEqualNode

      HTML

      -
      <div>This is the first element.</div>
      -<div>This is the second element.</div>
      -<div>This is the first element.</div>
      +
      <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>
      +<p id="output"></p>
      -

      CSS

      +

      CSS

      -
      #output {
      -  width: 440px;
      -  border: 2px solid black;
      -  border-radius: 5px;
      -  padding: 10px;
      -  margin-top: 20px;
      -  display: block;
      -}
      +
      #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");
      +
      let output = document.getElementById("output");
      +let divList  = document.getElementsByTagName("div");
       
      -output.innerHTML += "div 0 equals div 0: " + divList[0].isEqualNode(divList[0]) + "<br/>";
      -output.innerHTML += "div 0 equals div 1: " + divList[0].isEqualNode(divList[1]) + "<br/>";
      -output.innerHTML += "div 0 equals div 2: " + divList[0].isEqualNode(divList[2]) + "<br/>";
      +output.innerHTML += "div 0 equals div 0: " + divList[0].isEqualNode(divList[0]) + "<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écifications

      Spécification Supprime les propriétés suivantes : attributes, namespaceURI, prefix, et localName.
      Supprime les méthodes suivantes : isSupported(), hasAttributes(), getFeature(), setUserData(), et getUserData().
      diff --git a/files/fr/web/api/node/issamenode/index.html b/files/fr/web/api/node/issamenode/index.html index 1f3006b4b6..cab5401b56 100644 --- a/files/fr/web/api/node/issamenode/index.html +++ b/files/fr/web/api/node/issamenode/index.html @@ -35,10 +35,7 @@ translation_of: Web/API/Node/isSameNode <p id="output"></p> -

      JavaScript

      diff --git a/files/fr/web/api/node/issupported/index.html b/files/fr/web/api/node/issupported/index.html index 4e1c86bedb..3c241d4656 100644 --- a/files/fr/web/api/node/issupported/index.html +++ b/files/fr/web/api/node/issupported/index.html @@ -12,32 +12,31 @@ translation_of: Web/API/Node/isSupported

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

      -

      Syntaxe

      +

      Syntaxe

      boolValue = element.isSupported(feature, version)
      +

      Paramètres

      +
      -
      -

      Paramètres

      -
      feature
      -
      est une  {{domxref("DOMString")}} (chaîne de caractères) contenant le nom de la fonctionnalité à tester. C'est le même nom qui peut être passé à la méthode hasFeature de DOMImplementation. Les valeurs possibles définies dans la spécification DOM core sont listées dans la section Conformance de DOM Level 2.
      +
      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

      +

      Exemple

      -
      <div id="doc">
      -</div>
      +
      <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>
      +<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écifications

       

      diff --git a/files/fr/web/api/node/lastchild/index.html b/files/fr/web/api/node/lastchild/index.html index 3f31c8f722..37963f8473 100644 --- a/files/fr/web/api/node/lastchild/index.html +++ b/files/fr/web/api/node/lastchild/index.html @@ -13,19 +13,19 @@ translation_of: Web/API/Node/lastChild

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

      -

      Syntaxe

      +

      Syntaxe

      var childNode = node.lastChild;
       

       

      -

      Exemple

      +

      Exemple

       

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

      Spécification

      @@ -63,8 +63,4 @@ translation_of: Web/API/Node/lastChild

      Compatibilité des navigateurs

      - - -

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

      - -
       
      +

      {{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 index 52e72bec1f..1c88e6b8a2 100644 --- a/files/fr/web/api/node/lookupnamespaceuri/index.html +++ b/files/fr/web/api/node/lookupnamespaceuri/index.html @@ -12,12 +12,12 @@ translation_of: Web/API/Node/lookupNamespaceURI

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

      -

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

      +

      Du fait du bug 312019, 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 index 968deea85e..17cc48c622 100644 --- a/files/fr/web/api/node/lookupprefix/index.html +++ b/files/fr/web/api/node/lookupprefix/index.html @@ -14,10 +14,10 @@ translation_of: Web/API/Node/lookupPrefix

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

      -

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

      +

      En raison du bug 312019, 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 index b3e6cf3e7f..2a971a3067 100644 --- a/files/fr/web/api/node/nextsibling/index.html +++ b/files/fr/web/api/node/nextsibling/index.html @@ -12,42 +12,42 @@ translation_of: Web/API/Node/nextSibling

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

      -

      Syntaxe

      +

      Syntaxe

      nextNode = node.nextSibling
       
      -

      Notes

      +

      Notes

      Les navigateurs basés sur Gecko insèrent des nœuds texte dans un document pour représenter des espaces - vides dans le balisage source. Par conséquent, un nœud obtenu par exemple via Node.firstChild ou + 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? + 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

      +

      Exemple

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

      +

      Spécification

      -

      Compatibilité des navigateurs

      +

      Compatibilité des navigateurs

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

      -

      Voir aussi

      +

      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 index da778cda15..11c471fff1 100644 --- a/files/fr/web/api/node/nodename/index.html +++ b/files/fr/web/api/node/nodename/index.html @@ -72,7 +72,7 @@ translation_of: Web/API/Node/nodeName
      -

      Syntaxe

      +

      Syntaxe

      var str = node.nodeName;
       
      @@ -92,15 +92,15 @@ 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).

      +

      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

      +

      Spécification

      diff --git a/files/fr/web/api/node/nodetype/index.html b/files/fr/web/api/node/nodetype/index.html index d6f0a4eb2e..2f6cd30d79 100644 --- a/files/fr/web/api/node/nodetype/index.html +++ b/files/fr/web/api/node/nodetype/index.html @@ -17,16 +17,16 @@ translation_of: Web/API/Node/nodeType

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

      -

      Syntaxe

      +

      Syntaxe

      -
      Type = node .nodeType
      +
      Type = node .nodeType
       
      -

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

      +

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

      -

      Constantes

      +

      Constantes

      -

      Constantes de type nœud

      +

      Constantes de type nœud

      @@ -114,9 +114,9 @@ translation_of: Web/API/Node/nodeType
      -

      Exemples

      +

      Exemples

      -

      Différents types de noeuds

      +

      Différents types de noeuds

      document.nodeType === Node.DOCUMENT_NODE; // true (vrai)
       document.doctype.nodeType === Node.DOCUMENT_TYPE_NODE; // true  (vrai)
      @@ -133,13 +133,13 @@ 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.

      +

      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!");
      +
      var node = document.documentElement.firstChild;
      +if (node.nodeType != Node.COMMENT_NODE)
      +  console.log("You should comment your code well!");
      -

      Spécifications

      +

      Spécifications

      diff --git a/files/fr/web/api/node/nodevalue/index.html b/files/fr/web/api/node/nodevalue/index.html index 07e228342e..9f3fa1f3b3 100644 --- a/files/fr/web/api/node/nodevalue/index.html +++ b/files/fr/web/api/node/nodevalue/index.html @@ -12,7 +12,7 @@ translation_of: Web/API/Node/nodeValue

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

      -

      Syntaxe

      +

      Syntaxe

      value = node.nodeValue;
       
      @@ -80,10 +80,10 @@ translation_of: Web/API/Node/nodeValue

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

      -

      Spécification

      +

      Spécification

      Compatibilité des navigateurs

      diff --git a/files/fr/web/api/node/normalize/index.html b/files/fr/web/api/node/normalize/index.html index c58ba06945..e7ca55ed31 100644 --- a/files/fr/web/api/node/normalize/index.html +++ b/files/fr/web/api/node/normalize/index.html @@ -5,18 +5,18 @@ translation_of: Web/API/Node/normalize ---

      {{ ApiRef("DOM") }}

      -

      Résumé

      +

      Résumé

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

      -

      Syntaxe

      +

      Syntaxe

      élément.normalize();
       
      -

      Exemple

      +

      Exemple

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

      Notes

      +

      Notes

      -

      Spécification

      +

      Spécification

      {{ languages( { "en": "en/DOM/element.normalize", "pl": "pl/DOM/element.normalize" } ) }}

      diff --git a/files/fr/web/api/node/ownerdocument/index.html b/files/fr/web/api/node/ownerdocument/index.html index cc197c1d80..35b5eb6859 100644 --- a/files/fr/web/api/node/ownerdocument/index.html +++ b/files/fr/web/api/node/ownerdocument/index.html @@ -13,16 +13,16 @@ translation_of: Web/API/Node/ownerDocument

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

      -

      Syntaxe

      +

      Syntaxe

      document = element.ownerDocument;
       
        -
      • document est l'objet document parent de l'élément courant.
      • +
      • document est l'objet document parent de l'élément courant.
      -

      Exemple

      +

      Exemple

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

      Notes

      +

      Notes

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

      -

      Spécifications

      +

      Spécifications

      @@ -63,8 +63,4 @@ var html = d.documentElement;

      Compatibilité des navigateurs

      - - -

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

      - -
       
      +

      {{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 index 7da92f2334..673cb3b8b2 100644 --- a/files/fr/web/api/node/parentelement/index.html +++ b/files/fr/web/api/node/parentelement/index.html @@ -14,21 +14,21 @@ 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.
      +
      La propriété en lecture seule Node.parentElement renvoie le parent du noeud DOM ({{domxref("Element")}}) ou null si ce dernier n'a pas de parent ou si le parent n'est pas un {{domxref("Element")}} du DOM.
      -

      Syntaxe

      +

      Syntaxe

      parentElement = node.parentElement
       
      -

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

      +

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

      -

      Exemple

      +

      Exemple

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

      Compatibilité des navigateurs

      @@ -46,7 +46,7 @@ translation_of: Web/API/Node/parentElement
    • {{spec("http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#parent-element", "DOM Level 4: Node.parentElement", "WD")}}
    • -

      Voir aussi

      +

      Voir aussi

      • {{domxref("Node.parentNode")}}
      • diff --git a/files/fr/web/api/node/parentnode/index.html b/files/fr/web/api/node/parentnode/index.html index 50123e2cb6..5d2088cbf6 100644 --- a/files/fr/web/api/node/parentnode/index.html +++ b/files/fr/web/api/node/parentnode/index.html @@ -11,47 +11,42 @@ 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 .

        +

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

        -

        Syntaxe

        +

        Syntaxe

        parentNode = node.parentNode
        -

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

        +

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

        -

        Exemple

        +

        Exemple

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

        Notes

        +

        Notes

        -

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

        +

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

        -
        -
        • {{Domxref("Node.firstChild")}}
        • {{Domxref("Node.lastChild")}}
        • @@ -60,8 +55,4 @@ translation_of: Web/API/Node/parentNode
        • {{Domxref("Node.parentElement")}}
        • {{Domxref("Node.previousSibling")}}
        • {{Domxref("Node.removeChild")}}
        • -
        -
        -
        - -
        +
      \ 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 index 2f9f178b1f..31e02f5c7a 100644 --- a/files/fr/web/api/node/previoussibling/index.html +++ b/files/fr/web/api/node/previoussibling/index.html @@ -12,45 +12,45 @@ translation_of: Web/API/Node/previousSibling

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

      -

      Syntaxe

      +

      Syntaxe

      previousNode = node.previousSibling;
       

      Exemple

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

      Notes

      +

      Notes

      Les navigateurs basés sur Gecko insèrent des nœuds texte dans un document pour représenter des espaces - vides dans le balisage source. Par conséquent, un nœud obtenu par exemple via Node.firstChild ou + 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? + 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.

      +

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

      -

      Spécifications

      +

      Spécifications

      -

      Compatibilité des navigateurs

      +

      Compatibilité des navigateurs

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

      -

      Voir aussi

      +

      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 index cff831cdef..051a65c4e6 100644 --- a/files/fr/web/api/node/removechild/index.html +++ b/files/fr/web/api/node/removechild/index.html @@ -14,7 +14,7 @@ translation_of: Web/API/Node/removeChild

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

      -

      Syntaxe

      +

      Syntaxe

      var oldChild = node.removeChild(child);
       OR
      @@ -23,20 +23,20 @@ translation_of: Web/API/Node/removeChild
       
       
      • child est le nœud enfant à retirer du DOM.
      • -
      • node est le nœud parent de child.
      • +
      • node est le nœud parent de child.
      • oldchild conserve une référence au nœud enfant retiré. oldchild === child.

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

      -

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

      +

      Avec la seconde forme montrée en exemple, aucune référence à l'objet ancienEnfant n'est conservée ; ainsi, en supposant que votre code n'a conservé nulle part ailleurs cette référence à ce nœud, il devient immédiatement inutilisable et irrécupérable, et sera en général automatiquement supprimé 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 :​​
        +
      2. 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.
      3. si l'enfant n'existe pas dans le DOM de la page, la méthode provoque l'exception suivante :
        Uncaught TypeError: Failed to execute 'removeChild' on 'element': parameter 1 is not of type 'Node'.
      4. @@ -44,62 +44,62 @@ translation_of: Web/API/Node/removeChild

        Exemples

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

        Spécifications

        +

        Spécifications

        diff --git a/files/fr/web/api/node/replacechild/index.html b/files/fr/web/api/node/replacechild/index.html index 3fb6b0e8df..3cdf5aa950 100644 --- a/files/fr/web/api/node/replacechild/index.html +++ b/files/fr/web/api/node/replacechild/index.html @@ -14,7 +14,7 @@ translation_of: Web/API/Node/replaceChild

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

        -

        Syntaxe

        +

        Syntaxe

        replacedNode = parentNode.replaceChild(newChild, oldChild);
         
        diff --git a/files/fr/web/api/node/textcontent/index.html b/files/fr/web/api/node/textcontent/index.html index aa5b90cf7a..63e892d5b6 100644 --- a/files/fr/web/api/node/textcontent/index.html +++ b/files/fr/web/api/node/textcontent/index.html @@ -12,17 +12,17 @@ translation_of: Web/API/Node/textContent

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

        -

        Syntaxe

        +

        Syntaxe

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

        Description

        +

        Description

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

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

        -

        Exemple

        +

        Exemple

        // Étant donné le fragment de HTML suivant :
         //   <div id="divA">Ceci est un <span>exemple de</span> texte</div>
        @@ -58,27 +58,27 @@ document.getElementById("divA").textContent = "Ceci est un exemple de texte";
         
         

        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);
        -       }
        -     }
        -   );
        -  })();
        -}
        +
        // 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);
        +       }
        +     }
        +   );
        +  })();
        +}
        @@ -89,9 +89,9 @@ document.getElementById("divA").textContent = "Ceci est un exemple de texte";

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

        -

        Spécifications

        +

        Spécifications

        -
      +
      -- cgit v1.2.3-54-g00ecf
      Spécification