blob: 492baac6d134e7d44cddefd2c274e521ea22158a (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
|
---
title: element.replaceChild
slug: Web/API/Node/replaceChild
tags:
- API
- DOM
- Enfant
- Méthodes
- Noeuds
- Remplacement
translation_of: Web/API/Node/replaceChild
---
{{APIRef("DOM")}}
La méthode **`Node.replaceChild()`** remplace un nœud enfant du noeud spécifié par un autre nœud.
## Syntaxe
replacedNode = parentNode.replaceChild(newChild, oldChild);
- `newChild` est le nouveau nœud qui remplacera `oldChild`. S'il existe déjà dans le DOM, il sera d'abord enlevé.
- `oldChild` est le nœud existant à remplacer.
- `replaceNode` est le nœud remplacé. C'est le même nœud que `oldChild`.
## Exemple
```js
// Étant donné que :
// <div>
// <span id="childSpan">foo bar</span>
// </div>
// Crée un nœud d'élément vide
// sans ID, sans attributs et sans contenu
var sp1 = document.createElement("span");
// Donne un attribut id appelé "newSpan"
sp1.id = "newSpan";
// Crée du contenu pour le nouvel élément
var sp1_content = document.createTextNode("nouvel élément span de remplacement.");
// Applique ce contenu au nouvel élément
sp1.appendChild(sp1_content);
// Construit une référence au nœud existant à remplacer
var sp2 = document.getElementById("childSpan");
var parentDiv = sp2.parentNode;
// Remplacer le noeud existant sp2 par le nouvel élément span sp1
parentDiv.replaceChild(sp1, sp2);
// Résultat :
// <div>
// <span id="newSpan">nouvel élément span de remplacement.</span>
// </div>
```
## Spécifications
| Spécification | Statut | Commentaire |
| ---------------------------------------------------------------------------------------------------- | -------------------------------- | ----------- |
| {{SpecName("DOM WHATWG", "#dom-node-replacechild", "Node: replaceChild")}} | {{Spec2("DOM WHATWG")}} | |
## Compatibilité des navigateurs
{{Compat("api.Node.replaceChild")}}
## Voir aussi
- {{domxref("Node.removeChild")}}
- {{domxref("ChildNode.replaceWith")}}
|
