Element.prepend()
La méthode Element.prepend()
permet d'insérer un ensemble d'objets Node
ou des chaînes de caractères avant le premier élément enfant de l'élément courant. Les chaînes de caractères sont insérées comme des nœuds Text
.
Syntaxe
js
prepend(param1);
prepend(param1, param2);
prepend(param1, param2, /* ... ,*/ paramN);
Paramètres
Valeur de retour
undefined
.
Exceptions
DOMException
HierarchyRequestError
-
Levée lorsque le nœud ne peut pas être inséré à l'endroit indiqué dans la hiérarchie.
Exemples
Ajouter un élément
js
let div = document.createElement("div");
let p = document.createElement("p");
let span = document.createElement("span");
div.append(p);
div.prepend(span);
console.log(div.childNodes); // NodeList [ <span>, <p> ]
Ajouter du texte
js
let div = document.createElement("div");
div.append("Du texte");
div.prepend("Titre : ");
console.log(div.textContent); // "Titre : Du texte"
Ajouter un élément et du texte
js
let div = document.createElement("div");
let p = document.createElement("p");
div.prepend("Du texte", p);
console.log(div.childNodes); // NodeList [ #text "Du texte", <p> ]
prepend()
n'est pas disponible dans la portée créée par with
La méthode prepend()
ne fait pas partie de la portée créée par une instruction with
. Voir Symbol.unscopables
pour plus d'informations.
js
let div = document.createElement("div");
with (div) {
prepend("toto");
}
// ReferenceError: prepend is not defined
Spécifications
Specification |
---|
DOM Standard # ref-for-dom-parentnode-prepend① |
Compatibilité des navigateurs
BCD tables only load in the browser