files/ru/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
44

---
title: Document.documentElement
slug: Web/API/Document/documentElement
tags:
  - 'API,'
  - DOM
  - Свойство
  - Ссылка
  - Только для чтения
translation_of: Web/API/Document/documentElement
---
<p>{{ ApiRef("DOM") }}</p>

<p> <code><strong>Document.documentElement</strong></code> - свойство только для чтения, которое возвращает элемент <a href="/en-US/docs/DOM/element"><code>Element</code></a> , который является коренным элементом документа  <a href="/en-US/docs/DOM/document"><code>document</code></a> (например элемент <code>&lt;html&gt;</code> для HTML документов).</p>

<h2 id="Syntax" name="Syntax">Синтаксис</h2>

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

<h2 id="Example" name="Example">Пример</h2>

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

// firstTier -переменная объекта NodeList непосредственных потомков корневого элемента
for (var i = 0; i &lt; firstTier.length; i++) {
   // что-то делает с каждым прямым потомком корневого элемента
   // как и firstTier[i]
}</pre>

<h2 id="Notes" name="Notes">Примечания</h2>

<p>Это свойство удобно только для чтения для получения корневого элемента, связанного с любым документом.</p>

<p>HTML документ обычно содержит один дочерний узел - <code>&lt;html&gt;</code>,  возможно с объявлением  DOCTYPE перед ним. XML документы часто содержат множественные  дочерние узлы: корневой элемент, объявление DOCTYPE, и <a href="/en-US/docs/DOM/ProcessingInstruction"> инструкции по обработке</a>.</p>

<p>Поэтому вам стоит использовать <code>document.documentElement</code> вместо {{Domxref("document.firstChild")}} для доступа к корневому элементу.</p>

<h2 id="Спецификация">Спецификация</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>