Element : méthode replaceWith()
Baseline
Large disponibilité
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis avril 2018.
La méthode replaceWith() de l'interface Element remplace cet Element dans la liste des enfants de son parent par un ensemble d'objets Node ou de chaînes de caractères. Les chaînes de caractères sont insérées comme des nœuds équivalents Text.
Syntaxe
js
replaceWith(param1)
replaceWith(param1, param2)
replaceWith(param1, param2, /* …, */ paramN)
Paramètres
param1, …,paramN-
Un ensemble d'objets
Nodeou de chaînes de caractères par lesquels remplacer l'élément.
Valeur de retour
Aucune (undefined).
Exceptions
HierarchyRequestErrorDOMException-
Levée lorsque le nœud ne peut pas être inséré à l'emplacement défini dans la hiérarchie.
Exemples
Utiliser replaceWith()
js
const div = document.createElement("div");
const p = document.createElement("p");
div.appendChild(p);
const span = document.createElement("span");
p.replaceWith(span);
console.log(div.outerHTML);
// "<div><span></span></div>"
replaceWith() ne fait pas partie de la portée
La méthode replaceWith() ne fait pas partie de la portée créée par une instruction with. Voir Symbol.unscopables pour plus d'informations.
js
with (node) {
replaceWith("toto");
}
// ReferenceError: replaceWith is not defined
Spécifications
| Spécification |
|---|
| DOM # ref-for-dom-childnode-replacewith① |
Compatibilité des navigateurs
Voir aussi
- La méthode
Node.replaceChild() - L'interface
NodeList - La méthode
CharacterData.replaceWith() - La méthode
DocumentType.replaceWith()