Résumé
En lecture seule
Renvoie l'Element qui est l'élément racine du document (par exemple, l'élément <html> pour les documents HTML).
Syntaxe
var element = document.documentElement;
Exemple
var racine = document.documentElement;
var premierNiveau = racine.childNodes;
// premierNiveau est une NodeList des enfants directs de l'élément racine
for (var i = 0; i < premierNiveau.length; i++) {
// fait quelque chose avec chaque enfant direct de l'élément racine
// en tant que premierNiveau[i]
}
Notes
Cette propriété est une facilité en lecture seule permettant d'obtenir l'élément racine associé avec n'importe quel document.
Les documents HTML contiennent typiquement un seul nœud enfant, <html>, avec éventuellement une déclaration DOCTYPE avant celui-ci. Les documents XML contiennent souvent plusieurs nœuds enfants : l'élément racine, la déclaration DOCTYPE et des instructions de traitement.
C'est pourquoi il faut toujours utiliser document.documentElement plutôt que document.firstChild pour obtenir l'élément racine.
Spécification
- DOM Level 2 Core : Document.documentElement — traduction en français (non normative)