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