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/removechild/index.md | 110 ++++++++++++++--------------- 1 file changed, 55 insertions(+), 55 deletions(-) (limited to 'files/fr/web/api/node/removechild') diff --git a/files/fr/web/api/node/removechild/index.md b/files/fr/web/api/node/removechild/index.md index 051a65c4e6..727ad635d9 100644 --- a/files/fr/web/api/node/removechild/index.md +++ b/files/fr/web/api/node/removechild/index.md @@ -10,57 +10,53 @@ tags: - Suppression translation_of: Web/API/Node/removeChild --- -

{{ ApiRef("DOM") }}

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

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

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

Syntaxe

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

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

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

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

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

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

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

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

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

Exemples

+## Exemples -
<!--Sample HTML code-->
-<div id="top" align="center"> </div>
+```html
+
+
 

 
-<script type="text/javascript">
+
 
-<!--Sample HTML code-->
-<div id="top" align="center">
- <div id="nested"></div>
-</div>
+
+

+ 

+

 
-<script type="text/javascript">
+
+```
 
-
<!--Sample HTML code-->
+```html
+
 
-<div id="top" align="center">
-  <div id="nested"></div>
-</div>

+

+  

+

+```
 
-
// Supprime un élément spécifié quand son noeud parent est connu
+```js
+// Supprime un élément spécifié quand son noeud parent est connu
 var d = document.getElementById("top");
 var d_nested = document.getElementById("nested");
-var throwawayNode = d.removeChild(d_nested);

+var throwawayNode = d.removeChild(d_nested);
+```
 
-
// Supprime un élément spécifié sans avoir à spécifier son noeud parent
+```js
+// Supprime un élément spécifié sans avoir à spécifier son noeud parent
 var node = document.getElementById("nested");
 if (node.parentNode) {
   node.parentNode.removeChild(node);
-}

+}
+```
 
-
+```js
 // Supprime tous les enfant d'un élément
 var element = document.getElementById("top");
 while (element.firstChild) {
   element.removeChild(element.firstChild);
-}

+}
+```
 
-
Spécifications

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

+## Voir aussi
 
-
+- {{domxref("Node.replaceChild")}}
+- {{domxref("Node.parentNode")}}
+- {{domxref("ChildNode.remove")}}
-- 
cgit v1.2.3-54-g00ecf