Возвращает объект, подобный массиву, содержащий все элементы Element в данном документе, соответствующие селекторам selectors (это может быть единственный CSS-селектор или группа селекторов, разделенных запятыми). В отличие от объектов
NodeList
, возвращаемых методом
getElementsByTagName
и аналогичными ему, объект
NodeList
, возвращаемый этим методом, является статическим и содержит элементы, соответствующие селекторам, существовавшие на момент вызова метода.
void write(string text...)
Добавляет текст text
в конец документа. Этот метод можно использовать в ходе загрузки документа для вставки текста в позицию тега
<script>
или после вызова метода
ореп.
Подробности приводятся в разделе 15.10.2.
void writeln(string text...)
Этот метод похож на
HTMLDocument.write
за исключением того, что за добавляемым текстом следует символ перевода строки, что может быть удобным, например, при формировании содержимого тега
<рге>
.
События
Непосредственно в объекте
Document
броузеры возбуждают немного событий, но события, генерируемые в элементах, будут всплывать до объекта
Document
, вмещающего их. По этой причине объект
Document
поддерживает все свойства обработчиков событий, перечисленные в справочной статье
Element
. Подобно элементам
Element
, объект
Document
реализует методы интерфейса
EventTarget
.
Непосредственно в объекте
Document
броузеры возбуждают два события. Когда изменяется значение свойства
readyState
, броузеры возбуждают событие «readystatechange». Зарегистрировать обработчик этого события можно с помощью свойства
onreadystatechange
. Кроме того, броузеры возбуждают событие «DOMContentLoaded* (раздел 17.4), когда дерево документа будет готово к манипуляциям (но до окончания загрузки внешних ресурсов). Однако для регистрации обработчиков этого события необходимо использовать метод интерфейса
EventTarget
, потому что в объекте
Document
отсутствует свойство с именем
onDOMContentLoaded
.
DocumentFragment
смежные узлы и их поддеревья Node
Интерфейс
DocumentFragment
представляет часть (фрагмент) документа. Если говорить конкретно, то он представляет список смежных узлов документа и всех их потомков, но без общего родительского узла. Узлы
DocumentFragment
никогда не являются частью дерева документа, а унаследованное свойство
parentNode
в них всегда равно null. Однако особенность узлов
DocumentFragment
делает их очень полезными: когда поступает запрос на вставку
DocumentFragment
в дерево документа, вставляется не сам узел
DocumentFragment
, а все его дочерние узлы. Поэтому интерфейс
DocumentFragment
хорош в качестве временного хранилища для узлов, которые требуется вставить в документ все сразу. Создать новый пустой узел
DocumentFragment
можно с помощью метода
Document.createDocumentFragment.
Поиск элементов в узле
DocumentFragment
можно выполнить с помощью методов
querySelector
и
querySelectorAll,
которые действуют так же, как одноименные методы объекта
Document
.
Методы
Element querySelector(string selectors)
См. Document.querySelector.
NodeList querySelectorAll(string selectors)
См. Document.querySelectorAll.
DocumentType
объявление <!DOCTYPE>
документа Node
Этот редко используемый интерфейс представляет объявление
<!D0CTYPE>
документа. Свойство
doctype
объекта
Document
хранит узел
DocumentType
этого документа. Узлы
DocumentType
являются неизменяемыми, и нет никакого способа изменить их.
Узлы
DocumentType
используются для создания новых объектов
Document
с помощью метода
DOMImplementation.createDocument
. Новый объект
DocumentType
можно создать с помощью
DOMImplementation.createDocumentType
.
Свойства
readonly string name
Имя типа документа. Это идентификатор, который следует непосредственно за объявлением
<!D0CTYPE>
в начале документа и совпадает с именем тега корневого элемента документа. В HTML-документах это свойство содержит значение «html*.
readonly string publicId
Внешний идентификатор DTD или пустая строка, если идентификатор не указан.
readonly string systemId
Системный идентификатор DTD или пустая строка, если идентификатор не указан.
DOMException
исключение, возбужденное Web API
Большинство прикладных интерфейсов в клиентском JavaScript возбуждают исключение
DOMException
, когда им требуется сообщить об ошибке. Более подробная информация об ошибке содержится в свойствах
code
и
name
объекта. Обратите внимание, что исключение
DOMException
может быть возбуждено при чтении или изменении свойства или при вызове метода объекта.
DOMException
не является подклассом типа
Error
базового JavaScript, но функционально похож на него, и некоторые броузеры добавляют в него свойство