Document : méthode replaceChildren()
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 octobre 2020.
La méthode replaceChildren() de l'interface Document remplace les enfants existants d'un Document par un nouvel ensemble d'enfants défini.
Syntaxe
replaceChildren(param1)
replaceChildren(param1, param2)
replaceChildren(param1, param2, /* …, */ paramN)
Paramètres
param1, …,paramN-
Un ensemble d'objets
Nodeou de chaînes de caractères pour remplacer les enfants existants duDocument. Si aucun objet de remplacement n'est défini, leDocumentest vidé de tous ses nœuds enfants.
Valeur de retour
Aucune (undefined).
Exceptions
HierarchyRequestErrorDOMException-
Levée si les contraintes de l'arbre de nœuds (angl.) sont violées.
Exemples
Vider un document
replaceChildren() offre un mécanisme très pratique pour vider un document de tous ses enfants. Vous l'appelez sur le document sans aucun argument :
document.replaceChildren();
document.children; // HTMLCollection []
Spécifications
| Specification |
|---|
| DOM # ref-for-dom-parentnode-replacechildren① |
Compatibilité des navigateurs
Voir aussi
- La méthode
Document.prepend() - La méthode
Document.append()