Интерфейс Attr

Объекты Attr наследуют интерфейс Node, однако, поскольку фактически они не являются дочерними узлами описываемого ими элемента, DOM не считает их частью дерева документа. Поэтому атрибуты Node parentNode, previousSibling и nextSibling имеют значение null для объектов Attr. DOM рассматривает атрибуты как свойства элементов, а не как объекты, обладающие отдельной идентичностью относительно связанных с ними элементов; это должно повысить эффективность реализации таких возможностей, как атрибуты по умолчанию, связанные со всеми элементами заданного типа. Кроме того, узлы Attr не могут быть непосредственными дочерними узлами DocumentFragment. Однако они могут быть связаны с узлами Element, содержащимися в DocumentFragment. Иными словами, пользователям и разработчикам DOM следует помнить, что узлы Attr имеют некоторые общие черты с другими объектами, наследующими интерфейс Node, но при этом существенно от них отличаются.

Фактическое значение атрибута определяется следующим образом: если этому атрибуту явно присвоено какое-либо значение, это значение и является фактическим значением атрибута; в противном случае, если для этого атрибута существует объявление, включающее значение по умолчанию, фактическим значением атрибута является это значение по умолчанию; в противном случае атрибут отсутствует в данном элементе в модели структуры, пока его не добавят явно. Обратите внимание, что атрибут Node.nodeValue экземпляра Attr также можно использовать для получения строкового представления значения (значений) атрибута.

Если в документе экземпляра атрибуту явно не присвоено значение, но схема, связанная с документом, задает значение по умолчанию, будет создан узел атрибута, у которого specified установлено в false. Удаление узлов атрибутов, для которых в схеме определено значение по умолчанию, создает новый узел атрибута со значением по умолчанию и specified, установленным в false. Если при вызове Document.normalizeDocument() выполнялась проверка, узлы атрибутов, у которых specified равно false, пересчитываются в соответствии со значениями атрибутов по умолчанию, заданными в схеме. Если в схеме для этого атрибута не задано значение по умолчанию, узел атрибута удаляется.

В XML, где значение атрибута может содержать ссылки на сущности, дочерними узлами узла Attr могут быть узлы Text или EntityReference (если они используются; см. описание EntityReference).

DOM Core представляет все значения атрибутов в виде простых строк, даже если связанная с документом DTD или схема объявляет их значения имеющими определенный тип, например токенизированный.

Способ нормализации значения атрибута реализацией DOM зависит от того, насколько реализации известна используемая схема. Обычно атрибуты value и nodeValue узла Attr изначально возвращают нормализованное значение, предоставленное парсером. То же происходит после вызова Document.normalizeDocument() (при условии, что заданы нужные параметры). Однако после изменения это может быть не так — независимо от того, выполняется ли изменение путем непосредственного присвоения строкового значения или путем изменения дочерних узлов Attr. В частности, это верно при наличии ссылок на символы, поскольку они не представлены в DOM и влияют на нормализацию значения атрибута. С другой стороны, если реализации известна используемая схема в момент изменения значения атрибута и его тип отличается от CDATA, она может повторно нормализовать значение. Особенно это относится к специализированным реализациям DOM, например реализациям SVG DOM, которые хранят значения атрибутов во внутреннем формате, отличном от строки.

В следующей таблице приведены примеры соотношения значения атрибута в исходном документе (разобранного значения атрибута), значения, представленного в DOM, и сериализованного значения:

"x²=5"

"x²=5"

"x²=5"

"y<6"

"y<6"

"y<6"

"x=5
y=6"

"x=5 y=6"

"x=5
y=6"

"x=5
y=6"

"x=5 y=6"

"x=5 y=6"

<!ENTITY e '...&#10;...'> [...]> "x=5&e;y=6"

См. также спецификацию Document Object Model (DOM) Level 3 Core.