Element : méthode prepend()
Baseline
Large disponibilité
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 prepend() de l'interface Element insère un ensemble d'objets Node ou de chaînes de caractères avant le premier enfant de l'élément. Les chaînes de caractères sont insérées comme des nœuds Text équivalents.
Syntaxe
js
prepend(param1)
prepend(param1, param2)
prepend(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é à 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> ]
La méthode prepend() est inaccessible dans la portée
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
| Spécification |
|---|
| DOM # ref-for-dom-parentnode-prepend① |
Compatibilité des navigateurs
Voir aussi
- La méthode
Element.append() - La méthode
Node.appendChild() - La méthode
Node.insertBefore() - La méthode
Element.before() - La méthode
Element.insertAdjacentElement() - L'interface
NodeList