Element.replaceWith()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
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
replaceWith(param1);
replaceWith(param1, param2);
replaceWith(param1, param2, /* ... ,*/ paramN);
Paramètres
param1
, …,paramN
-
Un ensemble d'objets
Node
ou de chaînes de caractères par lesquels remplacer l'élément.
Exceptions
DOMException
HierarchyRequestError
-
Levée lorsque le nœud ne peut pas être inséré à l'emplacement indiqué dans la hiérarchie.
Exemples
Utiliser replaceWith()
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.
with (node) {
replaceWith("toto");
}
// ReferenceError: replaceWith is not defined
Spécifications
Specification |
---|
DOM Standard # ref-for-dom-childnode-replacewith① |
Compatibilité des navigateurs
BCD tables only load in the browser