files/de/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

---
title: document.documentElement
slug: Web/API/Document/documentElement
translation_of: Web/API/Document/documentElement
---
<p>{{ApiRef}}</p>

<h2 id="Summary" name="Summary">Zusammenfassung</h2>

<p><strong>Lesbar, nicht schreibbar</strong></p>

<p>Gibt das <a href="/en-US/docs/DOM/element"><code>Element</code></a> zurück, das die Wurzel des <code><a href="/en-US/docs/DOM/document">document</a></code> ist (zum Beispiel, das <code>&lt;html&gt;</code> Element für HTML Dokumente).</p>

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

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

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

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

// firstTier ist die NodeList von direkten Kindern des Wurzel-Elementes
for (var i = 0; i &lt; firstTier.length; i++) {
   // hier irgendwas mit den direkten Kindern des Wurzel-Elementes mit Hilfe
   // von firstTier[i] erledigen
}</pre>

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

<p>Dieses Objekt ist lesbar aber nicht schreibbar. Es ist praktisch um auf die Wurzel eines beliebigen Dokumentes zuzugreifen.</p>

<p>HTML Dokumente enthalten typischerweise ein einziges Tochter-Element<span style="line-height: 1.5;">, </span><code style="font-style: normal; line-height: 1.5;">&lt;html&gt;</code><span style="line-height: 1.5;">, manchmal mit einem DOCTYPE. XML-Doumente enthalten oft mehrere Tochter-Elemente, einen DOCTYPE und </span><a href="/en-US/docs/DOM/ProcessingInstruction" style="line-height: 1.5;">Verarbeitungshinweise</a><span style="line-height: 1.5;">.</span></p>

<p>Deswegen sollte <code>document.documentElement</code> statt <code>{{Domxref("document.firstElementChild")}}</code> benutzt werden, um auf das Wurzel-Element zuzugreifen.</p>

<h2 id="Specification" name="Specification">Spezifikation</h2>

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