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

См. также Спецификацию объектной модели документа (DOM) уровня 3 Core.