Document : méthode append()
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 append() de l'interface Document insère un ensemble d'objets Node ou de chaînes de caractères après le dernier enfant du document. Les chaînes de caractères sont insérées en tant que nœuds Text équivalents.
Cette méthode ajoute un enfant à un Document. Pour ajouter à un élément arbitraire dans l'arborescence, voir Element.append().
Syntaxe
append(param1)
append(param1, param2)
append(param1, param2, /* …, */ paramN)
Paramètres
param1, …,paramN-
Un ensemble d'objets
Nodeou de chaînes de caractères à insérer.
Valeur de retour
Aucune (undefined).
Exceptions
HierarchyRequestErrorDOMException-
Levée lorsque le nœud ne peut pas être inséré au point défini dans la hiérarchie.
Exemples
Ajouter un élément racine à un document
Si vous essayez d'ajouter un élément à un document HTML existant, cela peut provoquer une erreur de type HierarchyRequestError de DOMException étant donné qu'un élément <html> existe déjà.
let html = document.createElement("html");
document.append(html);
// HierarchyRequestError: The operation would yield an incorrect node tree.
Si vous créez un nouveau document sans aucun élément existant, vous pouvez ajouter un élément HTML racine (ou un élément SVG racine) :
let doc = new Document();
let html = document.createElement("html");
doc.append(html);
doc.children; // HTMLCollection [<html>]
Spécifications
| Specification |
|---|
| DOM # ref-for-dom-parentnode-append① |
Compatibilité des navigateurs
Voir aussi
- La méthode
Document.prepend() - La méthode
Element.append()