From 1407c8fdef01ecd0ffb8a8bd46e7113f119b9fde Mon Sep 17 00:00:00 2001 From: julieng Date: Sat, 2 Oct 2021 17:20:24 +0200 Subject: convert content to md --- files/fr/web/api/node/insertbefore/index.md | 160 +++++++++++----------------- 1 file changed, 65 insertions(+), 95 deletions(-) (limited to 'files/fr/web/api/node/insertbefore') diff --git a/files/fr/web/api/node/insertbefore/index.md b/files/fr/web/api/node/insertbefore/index.md index 289539552f..55abf106dd 100644 --- a/files/fr/web/api/node/insertbefore/index.md +++ b/files/fr/web/api/node/insertbefore/index.md @@ -10,47 +10,43 @@ tags: - Noeud translation_of: Web/API/Node/insertBefore --- -

{{APIRef("DOM")}}

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

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

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

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

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

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

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

Syntaxe

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

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

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

Valeur de retour

+### Valeur de retour -

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

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

Exemples

+## Exemples -

Exemple 1

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

+  foo bar
+

 
-<script>
+
+```
 
-
Exemple 2

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

+  foo bar
+

 
-<script>
-// Crée un nouvel élément simple de type <span>
+
+```
 
-
Il n'existe pas de méthode insertAfter. Il peut être émulé avec une combinaison des méthodes insertBefore et nextSibling.

+Il n'existe pas de méthode `insertAfter`. Il peut être émulé avec une combinaison des méthodes `insertBefore`[ ](/fr/docs/Web/API/Node/insertBefore)et [`nextSibling`](/fr/docs/Web/API/Node/nextSibling).
 
-
Dans l'exemple ci-dessus, sp1 pourrait être inséré après sp2 en utilisant :

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

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

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

+### Exemple 3
 
-
Insérer un élément avant le premier élément enfant en utilisant la propriété firstChild.

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

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

-
-
Spécifications

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

-        {{SpecName('DOM1','level-one-core.html#method-insertBefore','Node.insertBefore')}}
-      {{Spec2('DOM1')}}Introduced

-
-
Compatibilité des navigateurs

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

+
+```
+
+Si l'élément n'a pas de premier enfant, alors `firstChild` est `null`. L'élément est toujours ajouté au parent après le dernier enfant. Comme l'élément parent n'avait pas de premier enfant, il n'avait pas non plus de dernier enfant. Par conséquent, le nouvel élément est le seul élément, après l'insertion.
+
+## Spécifications
+
+| Specification                                                                                                | Status                           | Comment                                 |
+| ------------------------------------------------------------------------------------------------------------ | -------------------------------- | --------------------------------------- |
+| {{SpecName('DOM WHATWG','#dom-node-insertbefore','Node.insertBefore')}}             | {{Spec2('DOM WHATWG')}} | Fixes errors in the insertion algorithm |
+| {{SpecName('DOM4','#dom-node-insertbefore','Node.insertBefore')}}                     | {{Spec2('DOM4')}}         | Describes the algorithm in more detail  |
+| {{SpecName('DOM3 Core','core.html#ID-952280727','Node.insertBefore')}}                 | {{Spec2('DOM3 Core')}}     | No notable changes                      |
+| {{SpecName('DOM2 Core','core.html#ID-952280727','Node.insertBefore')}}                 | {{Spec2('DOM2 Core')}}     | No notable changes                      |
+| {{SpecName('DOM1','level-one-core.html#method-insertBefore','Node.insertBefore')}} | {{Spec2('DOM1')}}         | Introduced                              |
+
+## Compatibilité des navigateurs
+
+{{Compat("api.Node.insertBefore")}}
-- 
cgit v1.2.3-54-g00ecf