initial commit

1 files changed, 44 insertions, 0 deletions

diff --git a/files/ru/web/api/document/documentelement/index.html b/files/ru/web/api/document/documentelement/index.html
new file mode 100644
index 0000000000..27344558f8
--- /dev/null
+++ b/files/ru/web/api/document/documentelement/index.html
@@ -0,0 +1,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>