aboutsummaryrefslogtreecommitdiff
path: root/files/es/web/api/document/documentelement/index.html
blob: 30453050f736b704074ffcbe439bc95e94c1e496 (plain)
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
---
title: document.documentElement
slug: Web/API/Document/documentElement
tags:
  - Referencia_DOM_de_Gecko
translation_of: Web/API/Document/documentElement
---
<p>{{ ApiRef("DOM") }}</p>

<h3 id="Resumen" name="Resumen">Resumen</h3>

<p><strong>Solo-lectura</strong></p>

<p>Devuelve el <code><a href="es/DOM/element">Element</a></code> que es el elemento raíz de <a href="es/DOM/document">document</a> (por ejemplo, devuelve el elemento <code>&lt;html&gt;</code> en los documentos HTML).</p>

<h3 id="Sintaxis" name="Sintaxis">Sintaxis</h3>

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

<h3 id="Ejemplo" name="Ejemplo">Ejemplo</h3>

<pre class="eval">var rootElement = document.documentElement;
var firstTier = rootElement.childNodes;
// firstTier el la NodeList de los hijos directos del elemento raízof the direct children of the root element
for (var i = 0; i &lt; firstTier.length; i++) {
   // hacer algo con cada uno de los hijos directos del elemento raíz
   // como firstTier[i]
}
</pre>

<h3 id="Notas" name="Notas">Notas</h3>

<p>Esta propiedad es de sólo-lectura, facilitada para obtener el elemento raíz de cualquier documento.</p>

<p>Los documentos HTML contienen normalmente un único hijo directo, <code>&lt;html&gt;</code>, quizá con una declaración DOCTYPE antes que él. Los documento XML contienen a menudo, múltiples hijos: el elemento raíz, la declaración DOCTYPE y <a href="es/DOM/ProcessingInstruction"> processing instructions</a>.</p>

<p>Por tanto, deberías usar <code>document.documentElement</code> en lugar de {{ Domxref("document.firstChild") }} para obtener el elemento raíz.</p>

<h3 id="Especificaci.C3.B3n" name="Especificaci.C3.B3n">Especificación</h3>

<p><a class="external" href="http://www.w3.org/TR/DOM-Level-2-Core/core.html#ID-87CD092">DOM Level 2 Core: Document.documentElement</a></p>