Cette page a été traduite à partir de l'anglais par la communauté.Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.
Element.prepend()
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éthodeElement.prepend() permet d'insérer un ensemble d'objetsNode 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œudsText.
Syntaxe
prepend(param1);prepend(param1, param2);prepend(param1, param2, /* ... ,*/ paramN);Paramètres
param1, …,paramNUn ensemble d'objets
Nodeou de chaînes de caractères à insérer.
Valeur de retour
undefined.
Exceptions
DOMExceptionHierarchyRequestErrorLevée lorsque le nœud ne peut pas être inséré à l'endroit indiqué dans la hiérarchie.
Exemples
Ajouter un élément
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
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
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 parwith
La méthodeprepend() ne fait pas partie de la portée créée par une instructionwith. VoirSymbol.unscopables pour plus d'informations.
let div = document.createElement("div");with (div) { prepend("toto");}// ReferenceError: prepend is not definedSpécifications
| Specification |
|---|
| DOM # ref-for-dom-parentnode-prepend① |