files/pt-br/web/api/document/documentelement/index.html


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43

---
title: Document.documentElement
slug: Web/API/Document/documentElement
tags:
  - Propriedade
  - Referencia
  - raiz
translation_of: Web/API/Document/documentElement
---
<p>{{ ApiRef("DOM") }}</p>

<p>O  <strong>document.documentElement</strong>  retorna o <code><a href="/pt-BR/docs/Web/API/Element">Elemento</a></code> que é o elemento raiz do <code><a href="/pt-BR/docs/Web/API/Document">documento</a></code> (por exemplo, o elemento <code>&lt;html&gt;</code> para documentos HTML).</p>

<h2 id="Syntax" name="Syntax">Sintaxe</h2>

<pre class="syntaxbox">var <em>element</em> = document.documentElement;
</pre>

<h2 id="Example" name="Example">Exemplo</h2>

<pre class="brush:js">var rootElement = document.documentElement;
var primeiroNivel = rootElement.childNodes;

// primeiroNivel é a <code><a href="/pt-BR/docs/Web/API/NodeList">NodeList</a></code> do filho direto do elemento raíz
for (var i = 0; i &lt; primeiroNivel.length; i++) {
   // faça algo com cada filho direto do elemento raiz
   // como primeiroNivel[i]

}</pre>

<h2 id="Notes" name="Notes">Notas</h2>

<p>Esta propriedade é uma conveniência somente leitura para obter o elemento raiz associado com qualquer documento.</p>

<p>Documentos HTML tipicamente contém somente um único nó filho, <code>&lt;html&gt;</code>, talvez com uma declaração DOCTYPE antes dele. Documentos XML, frequentemete contêm múltiplos nós filhos: o elemento de raiz, a declaração DOCTYPE, e as <a href="/pt-BR/docs/Web/API/ProcessingInstruction">instruções de processamento</a>.</p>

<p>É por isso que você deve usar <code>document.documentElement</code> em vez de {{Domxref ("document.firstChild")}} para obter o elemento raiz.</p>

<h2 id="Specification" name="Specification">Especificações</h2>

<ul>
 <li><a class="external" href="http://www.w3.org/TR/DOM-Level-2-Core/core.html#ID-87CD092">Núcleo DOM Nível 2:   document.documentElement</a></li>
</ul>