В этом параграфе описывается руководство в целом: для кого оно, как представлена информация, и как вы можете использовать примеры статьи в своих собственных разработках.
Заметьте, что этот документ находится на стадии разработки и на данный момент не является полным списком всех DOM-методов и свойств доступных в Gecko. Тем не менее, каждый параграф документа является полным для описываемого объекта. Как только справочная информация к различным API станет доступной, она будет добавлена.
Читатель должен быть веб-разработчиком или продвинутым веб-пользователем и иметь представление об устройстве веб-страниц. Эта статья не предполагает знакомства читателя с DOM, XML, веб-сервисами, веб-стандартами и даже с JavaScript, языком, через который DOM доступен читателю. Но подразумевается знакомство с HTML, разметкой, базовой структурой веб-страниц, браузерами и таблицами стилей.
Здесь представлен вводный материал с большим количеством примеров и хорошо организованными объяснениями, который должен пригодиться начинающим и продвинутым разработчикам. Эта статья является не только руководством для начинающих. В основном этот документ является справочным руководством по API.
Mozilla, Firefox, Netscape 6+ и другие основанные на Mozilla браузеры имеют одинаковые реализации DOM, поскольку все они основаны на одном движке. naturally, it applies only to products based on the same version of Gecko, but it's tricky to explain
Gecko — программный компонент всех этих браузеров, который отвечает за синтаксический разбор HTML, внешний вид страниц, объектную модель документа и даже рендеринг интерфейсов приложений. Gecko является быстрым, совместимым со стандартами движком рендеринга, который обеспечивает поддержку стандартов W3C DOM и похожую на DOM (но не стандартизированную) модель документа браузера в контексте веб-страницы и интерфейса приложения.
Хотя интерфейс приложения и содержимое, отображаемое браузером во многом различны, DOM обрабатывает их одинаково, как иерархию узлов.(commenting this incomplete sentence out for now...) The tree structure of the DOM (which in its application to the user
Каждое описание в справочнике по API включает синтаксис, входные и выходные данные, пример использования, дополнительные замечания и ссылку на соответствующую спецификацию.
Как правило атрибуты только-для-чтения имеют однострочный синтаксис, поскольку им нельзя присвоить значения и они могут быть только прочитаны. Пример использования атрибута только-для-чтения availHeight объекта screen выглядит примерно так:
Это означает, что вы можете использовать свойство только в правой части операции присваивания; атрибуты, которым можно присвоить значение, приведены в примере:
В основном, данные и методы описываемых объектов, будут приводиться в примерах в контексте простых типов, таких как element для всех элементов, document для объектов верхнего уровня, table для объекта TABLE и т.д. (см. Важные типы данных для информации о типах данных).
Большинство примеров в этом справочнике являются самодостаточными файлами, которые можно использовать просто копируя и вставляя их в новый файл, а затем открывая в браузере. Другие же являются фрагментами кода. Их вы сможете запустить только поместив в функции. Например свойство window.document может быть получено в теле функции, которая вызывается нажатием соответствующей кнопки:
<html>
<script>
function testWinDoc() {
doc= window.document;
alert(doc.title);
}
</script>
<button onclick="testWinDoc();">test document property</button>
</html>
Похожие функции и страницы можно сделать для методов и свойств объектов, которые еще недоступны к использованию. См. параграф Тестирование DOM API для введения в средства тестирования, которые вы можете использовать для большого количества различных API.
{{ 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" } ) }}