Element.replaceWith()
Baseline
Widely available
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 Element.replaceWith() remplace l'élément courant 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 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.
Exceptions
DOMExceptionHierarchyRequestError-
Levée lorsque le nœud ne peut pas être inséré à l'emplacement indiqué 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 de with
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
| Specification |
|---|
| DOM # ref-for-dom-childnode-replacewith① |
Compatibilité des navigateurs
Chargement…