diff options
author | julieng <julien.gattelier@gmail.com> | 2021-10-02 17:20:24 +0200 |
---|---|---|
committer | SphinxKnight <SphinxKnight@users.noreply.github.com> | 2021-10-02 17:30:20 +0200 |
commit | 1407c8fdef01ecd0ffb8a8bd46e7113f119b9fde (patch) | |
tree | 30a56efd3eff3a01bd1611e1840fdbbfacf544a4 /files/fr/web/api/node/removechild | |
parent | c05efa8d7ae464235cf83d7c0956e42dc6974103 (diff) | |
download | translated-content-1407c8fdef01ecd0ffb8a8bd46e7113f119b9fde.tar.gz translated-content-1407c8fdef01ecd0ffb8a8bd46e7113f119b9fde.tar.bz2 translated-content-1407c8fdef01ecd0ffb8a8bd46e7113f119b9fde.zip |
convert content to md
Diffstat (limited to 'files/fr/web/api/node/removechild')
-rw-r--r-- | files/fr/web/api/node/removechild/index.md | 110 |
1 files changed, 55 insertions, 55 deletions
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 --- -<p>{{ ApiRef("DOM") }}</p> +{{ ApiRef("DOM") }} -<p>La méthode <code><strong>Node.removeChild()</strong></code> retire un nœud enfant de l'arbre DOM et retourne le nœud retiré.</p> +La méthode **`Node.removeChild()`** retire un nœud enfant de l'arbre DOM et retourne le nœud retiré. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox"><em>var oldChild</em> = <em>node</em>.removeChild(<em>child</em>); -<strong>OR</strong> -<em>node</em>.removeChild(<em>child</em>); -</pre> + var oldChild = node.removeChild(child); + OR + node.removeChild(child); -<ul> - <li><code>child</code> est le nœud enfant à retirer du DOM.</li> - <li><code>node </code>est le nœud parent de <code>child</code>.</li> - <li><code>oldchild</code> conserve une référence au nœud enfant retiré. <code>oldchild</code> === <code>child</code>.</li> -</ul> +- `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`. -<p>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 <code>ancienEnfant</code><em>. </em></p> +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`_._ -<p>Avec la seconde forme montrée en exemple, aucune référence à l'objet <code>ancienEnfant</code> 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 <a href="/fr/docs/Web/JavaScript/Gestion_de_la_m%C3%A9moire">automatiquement supprimé</a> de la mémoire après un court moment.</p> +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. -<p>Si <code>child</code> n'est pas un enfant du noeud <code>element</code>, la méthode provoque une exception. Une exception sera aussi lancée dans la cas où le nœud <code>enfant </code>est bien un enfant du nœud <code>element </code>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 <code>element </code>(comme <em>blur</em>).</p> +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*). -<p>La méthode peut lever une exception de deux façons :</p> +La méthode peut lever une exception de deux façons : -<ol> - <li>Si <code>enfant</code> é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 :<code></code><br> - <code>Uncaught NotFoundError: Failed to execute 'removeChild' on 'element': The node to be removed is not a child of this node</code>.</li> - <li>si l'<code>enfant</code> n'existe pas dans le DOM de la page, la méthode provoque l'exception suivante :<br> - <code>Uncaught TypeError: Failed to execute 'removeChild' on 'element': parameter 1 is not of type 'Node'.</code></li> -</ol> +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'.` -<h2 id="Exemples">Exemples</h2> +## Exemples -<pre class="brush: html"><!--Sample HTML code--> -<div id="top" align="center"> </div> +```html +<!--Sample HTML code--> +<div id="top" align="center"> </div> -<script type="text/javascript"> +<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> +</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"> +<script type="text/javascript"> var top = document.getElementById("top"); var nested = document.getElementById("nested"); @@ -69,44 +65,48 @@ translation_of: Web/API/Node/removeChild // ...... garbage = top.removeChild(nested); // Cas test 1 : la méthode dans le second appel ici, lance l'exception (1) -</script></pre> +</script> +``` -<pre class="brush: html"><!--Sample HTML code--> +```html +<!--Sample HTML code--> -<div id="top" align="center"> - <div id="nested"></div> -</div></pre> +<div id="top" align="center"> + <div id="nested"></div> +</div> +``` -<pre class="brush:js">// 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);</pre> +var throwawayNode = d.removeChild(d_nested); +``` -<pre class="brush:js">// 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); -}</pre> +} +``` -<pre class="brush:js"> +```js // Supprime tous les enfant d'un élément var element = document.getElementById("top"); while (element.firstChild) { element.removeChild(element.firstChild); -}</pre> +} +``` -<h2 id="Sp.C3.A9cification">Spécifications</h2> +## Spécifications -<ul> - <li><a href="http://www.w3.org/TR/REC-DOM-Level-1/level-one-core.html#method-removeChild">DOM Level 1 Core: removeChild</a> — <a href="http://xmlfr.org/w3c/TR/REC-DOM-Level-1/level-one-core.html#method-removeChild">traduction en français</a> (non normative)</li> - <li><a href="http://www.w3.org/TR/DOM-Level-2-Core/core.html#ID-1734834066">DOM Level 2 Core: removeChild</a> — <a href="http://www.yoyodesign.org/doc/w3c/dom2/core/core.html#ID-1734834066">traduction en français</a> (non normative)</li> - <li><a href="http://www.w3.org/TR/DOM-Level-3-Core/core.html#ID-1734834066">DOM Level 3 Core: removeChild</a></li> -</ul> +- [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) -<h2 id="Voir_aussi">Voir aussi</h2> +## Voir aussi -<ul> - <li>{{domxref("Node.replaceChild")}}</li> - <li>{{domxref("Node.parentNode")}}</li> - <li>{{domxref("ChildNode.remove")}}</li> -</ul> +- {{domxref("Node.replaceChild")}} +- {{domxref("Node.parentNode")}} +- {{domxref("ChildNode.remove")}} |