Интерфейс 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"

См. также Спецификацию документа Object Model (DOM) Level 3 Core.