JavaScript. Подробное руководство, 6-е издание, Флэнаган Дэвид

JavaScript. Подробное руководство, 6-е издание

на обложку

Флэнаган Дэвид

Шрифт:

См. 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, но функционально похож на него, и некоторые броузеры добавляют в него свойство

message

для совместимости с классом

Error

Константы

unsigned

short INDEX__SIZE_ERR = 1

unsigned

short HIERARCHY_REUEST_ERR = 3

unsigned

short WRONG_DOCUMENT_ERR = 4

unsigned

short INVALID_CHARACTER_ERR = 5

unsigned

short NO_MODIFICATION_ALLOWED_ERR = 7

unsigned

short N0T_F0UND_ERR = 8

unsigned

short NOT_SUPPORTED_ERR = 9

unsigned

short INVALID_STATE_ERR = 11

unsigned

short SYNTAX_ERR = 12

DOMImplementation

глобальные методы DOM

Объект

DOMImplementation

определяет методы, не относящиеся к какому-либо конкретному объекту

Document

, а являющиеся «глобальными» для реализации

DOM

. Ссылку на объект

DOMImplementation

можно получить через свойство

implementation

любого объекта

Document

Методы

Document createDocument(string namespace, string qualifiedName, DocumentType doctype)

Создает и возвращает

новый объект

Document

XML-документа. Если указан аргумент qualifiedName, создается корневой элемент с этим именем и добавляется в документ как значение его свойства

documentElement

. Если qualifiedName включает префикс пространства имен и двоеточие, пространство имен должно быть представлено идентификатором URI, уникально идентифицирующим его. Если аргумент doctype содержит значение, отличное от null, свойству

ownerDocument

этого объекта

DocumentType

присваивается вновь созданный документ, а узел

DocumentType

добавляется в новый документ.

DocumentType createDocumentType(string qualifiedName, publicld, systemld)

Создает новый узел

DocumentType

, представляющий объявление

<!D0CTYPE>,

который можно передать методу

createDocument.

Document createHTMLDocument(string title)

Создает новый объект

HTMLDocument

с готовым деревом документа, включающий указанный заголовок. Значением свойства

documentElement

возвращаемого объекта является элемент

<html>,

и этот корневой элемент содержит вложенные теги

<head>

<body>.

Элемент

<head>

в свою очередь включает вложенный элемент

<title>

с дочерним текстовым узлом, содержащим строку

title

DOMSettableTokenList

список лексем с настраиваемым строковым значением DOMTokenList

Объект

DOMSettableTokenList

является подтипом

DOMTokenList

, имеющим дополнительное свойство

value

, которому можно присвоить сразу полный список лексем.

Свойство

classList

объекта

Element

является ссылкой на объект

DOMTokenList

, который представляет множество лексем в свойстве

className

в виде строки. Если потребуется присвоить свойству

classList

сразу все лексемы, можно просто присвоить новую строку свойству

className

. Свойство

sandbox

элемента

IFrame

несколько отличается. Это свойство и HTML-атрибут, на который оно опирается, было определено в спецификации HTML5, и потому не было никакой необходимости использовать смесь из старого строкового представления и объекта

DOMTokenList

. Это свойство просто определено как объект

DOMSettableTokenList

, что позволяет читать его и присваивать ему значение, как если бы это была простая строка, или использовать методы и интерпретировать его как множество лексем. Свойство

htmlFor

объекта

Output

и свойство

audio

объекта

Video

также являются объектами

DOMSettableTokenList

Свойства

string value

Представление множества лексем в виде строки, в которой лексемы разделены пробелами. Это свойство позволяет обрабатывать множество как единственную строку. Однако обычно не возникает необходимости использовать это свойство явно: при использовании объекта

DOMSettableTokenList

в контексте, где требуется строка, возвращается именно это строковое значение. A если выполнить присваивание строки объекту

DOMSettableTokenList

, строка неявно будет записана в это свойство.