Интерфейс Attr

Интерфейс Attr представляет атрибут в объекте Element. Обычно допустимые значения атрибута определены в схеме, связанной с документом.

Объекты 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.