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
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
|
---
title: Предисловие
slug: Справочная_информация_по_Gecko_DOM/Предисловие
---
<p> </p>
<h3 id=".D0.9E_.D0.BF.D1.80.D0.B5.D0.B4.D0.B8.D1.81.D0.BB.D0.BE.D0.B2.D0.B8.D0.B8" name=".D0.9E_.D0.BF.D1.80.D0.B5.D0.B4.D0.B8.D1.81.D0.BB.D0.BE.D0.B2.D0.B8.D0.B8">О предисловии</h3>
<p>В этом параграфе описывается руководство в целом: для кого оно, как представлена информация, и как вы можете использовать примеры статьи в своих собственных разработках.</p>
<p>Заметьте, что этот документ находится на стадии разработки и на данный момент не является полным списком всех DOM-методов и свойств доступных в Gecko. Тем не менее, каждый параграф документа является полным для описываемого объекта. Как только справочная информация к различным API станет доступной, она будет добавлена.</p>
<h3 id=".D0.94.D0.BB.D1.8F_.D0.BA.D0.BE.D0.B3.D0.BE_.D1.8D.D1.82.D0.B0_.D1.81.D1.82.D0.B0.D1.82.D1.8C.D1.8F" name=".D0.94.D0.BB.D1.8F_.D0.BA.D0.BE.D0.B3.D0.BE_.D1.8D.D1.82.D0.B0_.D1.81.D1.82.D0.B0.D1.82.D1.8C.D1.8F">Для кого эта статья</h3>
<p>Читатель должен быть веб-разработчиком или продвинутым веб-пользователем и иметь представление об устройстве веб-страниц. Эта статья не предполагает знакомства читателя с DOM, <a href="ru/XML">XML</a>, веб-сервисами, веб-стандартами и даже с <a href="ru/JavaScript">JavaScript</a>, языком, через который DOM доступен читателю. Но подразумевается знакомство с <a href="ru/HTML">HTML</a>, разметкой, базовой структурой веб-страниц, браузерами и таблицами стилей.</p>
<p>Здесь представлен вводный материал с большим количеством примеров и хорошо организованными объяснениями, который должен пригодиться начинающим и продвинутым разработчикам. Эта статья является не только руководством для начинающих. В основном этот документ является справочным руководством по API.</p>
<h3 id=".D0.A7.D1.82.D0.BE_.D1.82.D0.B0.D0.BA.D0.BE.D0.B5_Gecko.3F" name=".D0.A7.D1.82.D0.BE_.D1.82.D0.B0.D0.BA.D0.BE.D0.B5_Gecko.3F">Что такое Gecko?</h3>
<p>Mozilla, Firefox, Netscape 6+ и другие основанные на Mozilla браузеры имеют одинаковые реализации DOM, поскольку все они основаны на одном движке. <span class="comment">naturally, it applies only to products based on the same version of Gecko, but it's tricky to explain</span></p>
<p>Gecko — программный компонент всех этих браузеров, который отвечает за синтаксический разбор HTML, внешний вид страниц, объектную модель документа и даже рендеринг интерфейсов приложений. Gecko является быстрым, совместимым со стандартами движком рендеринга, который обеспечивает поддержку стандартов W3C DOM и похожую на DOM (но не стандартизированную) модель документа браузера в контексте веб-страницы и интерфейса приложения.</p>
<p>Хотя интерфейс приложения и содержимое, отображаемое браузером во многом различны, DOM обрабатывает их одинаково, как иерархию узлов.<span class="comment">(commenting this incomplete sentence out for now...) The tree structure of the DOM (which in its application to the user</span></p>
<h3 id=".D0.A1.D0.B8.D0.BD.D1.82.D0.B0.D0.BA.D1.81.D0.B8.D1.81_API" name=".D0.A1.D0.B8.D0.BD.D1.82.D0.B0.D0.BA.D1.81.D0.B8.D1.81_API">Синтаксис API</h3>
<p>Каждое описание в справочнике по API включает синтаксис, входные и выходные данные, пример использования, дополнительные замечания и ссылку на соответствующую спецификацию.</p>
<p>Как правило атрибуты только-для-чтения имеют однострочный синтаксис, поскольку им нельзя присвоить значения и они могут быть только прочитаны. Пример использования атрибута только-для-чтения <code>availHeight</code> объекта <code>screen</code> выглядит примерно так:</p>
<div><img alt="Image:Preface2.gif"></div>
<p>Это означает, что вы можете использовать свойство только в правой части операции присваивания; атрибуты, которым можно присвоить значение, приведены в примере:</p>
<div><img alt="Image:Prefacea.gif"></div>
<p>В основном, данные и методы описываемых объектов, будут приводиться в примерах в контексте простых типов, таких как <code>element</code> для всех элементов, <code>document</code> для объектов верхнего уровня, table для объекта <code>TABLE</code> и т.д. (см. <a href="ru/%d0%a1%d0%bf%d1%80%d0%b0%d0%b2%d0%be%d1%87%d0%bd%d0%b0%d1%8f_%d0%b8%d0%bd%d1%84%d0%be%d1%80%d0%bc%d0%b0%d1%86%d0%b8%d1%8f_%d0%bf%d0%be_Gecko_DOM/%d0%92%d0%b2%d0%b5%d0%b4%d0%b5%d0%bd%d0%b8%d0%b5#.D0.92.D0.B0.D0.B6.D0.BD.D1.8B.D0.B5_.D1.82.D0.B8.D0.BF.D1.8B_.D0.B4.D0.B0.D0.BD.D0.BD.D1.8B.D1.85">Важные типы данных</a> для информации о типах данных).</p>
<h3 id=".D0.98.D1.81.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BF.D1.80.D0.B8.D0.BC.D0.B5.D1.80.D0.BE.D0.B2" name=".D0.98.D1.81.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BF.D1.80.D0.B8.D0.BC.D0.B5.D1.80.D0.BE.D0.B2">Использование примеров</h3>
<p>Большинство примеров в этом справочнике являются самодостаточными файлами, которые можно использовать просто копируя и вставляя их в новый файл, а затем открывая в браузере. Другие же являются фрагментами кода. Их вы сможете запустить только поместив в функции. Например свойство <a href="ru/DOM/window.document">window.document</a> может быть получено в теле функции, которая вызывается нажатием соответствующей кнопки:</p>
<pre><html>
<script>
function testWinDoc() {
doc= window.document;
alert(doc.title);
}
</script>
<button onclick="testWinDoc();">test document property</button>
</html>
</pre>
<p>Похожие функции и страницы можно сделать для методов и свойств объектов, которые еще недоступны к использованию. См. параграф <a href="ru/%d0%a1%d0%bf%d1%80%d0%b0%d0%b2%d0%be%d1%87%d0%bd%d0%b0%d1%8f_%d0%b8%d0%bd%d1%84%d0%be%d1%80%d0%bc%d0%b0%d1%86%d0%b8%d1%8f_%d0%bf%d0%be_Gecko_DOM/%d0%92%d0%b2%d0%b5%d0%b4%d0%b5%d0%bd%d0%b8%d0%b5#.D0.A2.D0.B5.D1.81.D1.82.D0.B8.D1.80.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_DOM_API">Тестирование DOM API</a> для введения в средства тестирования, которые вы можете использовать для большого количества различных API.</p>
<p>{{ languages( { "fr": "fr/R\u00e9f\u00e9rence_du_DOM_Gecko/Pr\u00e9face", "ja": "ja/Gecko_DOM_Reference/Preface", "ko": "ko/Gecko_DOM_Reference/Preface", "pl": "pl/Dokumentacja_Gecko_DOM/Przedmowa", "zh-cn": "cn/Gecko_DOM_\u53c2\u8003/Preface" } ) }}</p>
|
