DOM:document.documentElement
Un article de MDC.
Sommaire |
[modifier] 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).
[modifier] Syntaxe
var element = document.documentElement;
[modifier] 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]
}
[modifier] 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.
[modifier] Spécification
- DOM Level 2 Core : Document.documentElement — traduction en français (non normative)