Element : méthode before()
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 before() de l'interface Element permet d'insérer un ensemble d'objets Node ou de chaînes de caractères dans la liste des enfants du parent de cet Element, juste avant celui-ci. Les chaînes de caractères sont insérées comme des nœuds Text équivalents.
Syntaxe
js
before(param1)
before(param1, param2)
before(param1, param2, /* …, */ paramN)
Paramètres
param1, …,paramN-
Un ensemble d'objets
Nodeou de chaînes de caractères à insérer.
Exceptions
HierarchyRequestErrorDOMException-
Levée lorsque le nœud ne peut pas être inséré à l'emplacement indiqué dans la hiérarchie.
Exemples
Insérer un élément
js
let container = document.createElement("div");
let p = document.createElement("p");
container.appendChild(p);
let span = document.createElement("span");
p.before(span);
console.log(container.outerHTML);
// "<div><span></span><p></p></div>"
Insérer du texte
js
let container = document.createElement("div");
let p = document.createElement("p");
container.appendChild(p);
p.before("Texte");
console.log(container.outerHTML);
// "<div>Texte<p></p></div>"
Insérer un élément et du texte
js
let container = document.createElement("div");
let p = document.createElement("p");
container.appendChild(p);
let span = document.createElement("span");
p.before(span, "Texte");
console.log(container.outerHTML);
// "<div><span></span>Texte<p></p></div>"
Spécifications
| Spécification |
|---|
| DOM # ref-for-dom-childnode-before① |
Compatibilité des navigateurs
Voir aussi
- La méthode
Element.after() - La méthode
Element.append() - La méthode
Element.insertAdjacentElement() - La méthode
CharacterData.before() - La méthode
DocumentType.before() - La méthode
Node.appendChild() - La méthode
Node.insertBefore() - L'interface
NodeList