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