Element.replaceWith()
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 <code>replaceWith()</code>
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>"
<code>replaceWith()</code> ne fait pas partie de la portée de <code>with</code>
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