Этот тип представляет атрибут элемента DOM в виде объекта. В большинстве методов DOM вы, вероятно, непосредственно извлекаете атрибут в виде строки (например, Element.getAttribute ()
, но некоторые функции (например, Element.getAttributeNode ()
) или средства итерации, отдают тип Attr
.
Свойства
name
Только для чтения- Имя аттрибута.
namespaceURI
Только для чтенияDOMString
представление URI пространства имен атрибута, или NULL если нет никакого пространства имен.localName
Только для чтенияDOMString
представление локальной части полного имени атрибута.prefix
Только для чтенияDOMString
представление префикс пространства имен атрибута, или NULL, если префикс не указан.ownerElement
Только для чтения-
Элемнет, содержащий атрибут.
Примечание: DOM уровень 4 удалил это свойство.Предполагалось, что, поскольку Вы получаете объект Attr от
Element
, вы заранее должны знать связанный элемент. Поскольку это не верно в случаях, подобных объектам Attr, возвращаемымDocument.evaluate
, DOM уровень жизни вновь ввел это свойство.Gecko выводит предупреждение об использовании, начиная с Gecko 7.0 (Firefox 7.0 / Thunderbird 7.0 / SeaMonkey 2.4). Это предупреждение было удалено в Gecko 49.0 (Firefox 49.0 / Thunderbird 49.0 / SeaMonkey 2.46).
specified
Только для чтения- Это свойство всегда возвращает true. Первоначально, оно возвращало true, если атрибут был явно определен в исходном коде или сценарием и false, если ее значение прибыло из значения по умолчанию определенном в DTD документе.
value
- Значение атрибута
Примечание: уровень DOM 3 определил namespaceURI
, localName
и prefix
в Node
интерфейсе. В DOM4 они были перемещены в Attr
.
Это изменение реализовано в Chrome с версии 46.0 и Firefox с версии 48.
Устаревшие свойства и методы
Эти свойства устарели. Там где это допустимо представлена соответствующая замена.
attributes
- Это свойство всегда возвращает значение
NULL
. childNodes
Вышла из употребления с версии Gecko 14- Это свойство всегда возвращает пустой
NodeList
. firstChild
Вышла из употребления с версии Gecko 14- Это свойство всегда возвращает значение
NULL
. isId
Только для чтения- Указывает, является ли атрибут "ID attribute". "ID attribute" - это атрибут, значение которого должно быть уникальным в документе DOM. В HTML DOM "id" является единственным атрибутом ID, но XML-документы могут определять иные. Уникальность атрибута часто определяется DTD или другим описанием схемы.
lastChild
Вышла из употребления с версии Gecko 14- Это свойство всегда возвращает значение
NULL
. nextSibling
- Это свойство всегда возвращает значение
NULL
. nodeName
- Используйте
Attr.name
взамен. nodeType
- Это свойство теперь всегда возвращает 2 (
ATTRIBUTE_NODE
). nodeValue
- Используйте
Attr.value
взамен. ownerDocument
- Вы не должны были использовать это свойство в первую очередь, поэтому вам, вероятно, все равно, что это свойство больше не используется.
parentNode
- Это свойство всегда возвращает значение
NULL
. previousSibling
- Это свойство всегда возвращает значение
NULL
. schemaTypeInfo
Только для чтения- Сведения о типе, связанные с этим атрибутом. В то время как информация о типе, содержащаяся в этом атрибуте, гарантированно будет правильной после загрузки документа или вызова
Document.normalizeDocument
, это свойство может быть ненадежным, если узел был перемещен. specified
- Это свойство всегда возвращает значение
true
. textContent
- Используйте
Attr.value
взамен.
The following methods have been deprecated:
appendChild()
Вышла из употребления с версии Gecko 14- Измените значение
Attr.value
взамен. cloneNode()
- Вы не должны были использовать это в первую очередь, поэтому вам, вероятно, все равно, что это больше не используется.
createAttribute()
- Используйте
Element.setAttribute()
взамен. createAttributeNS()
- Используйте
Element.setAttributeNS()
взамен. getAttributeNode()
- Используйте
Element.getAttribute()
взамен. getAttributeNodeNS()
- Используйте
Element.getAttributeNS()
взамен. hasAttributes()
Вышла из употребления с версии Gecko 21.0- Этот метод всегда возвращает значение false.
hasChildNodes()
- Этот метод всегда возвращает значение false.
insertBefore()
- Измените значение
Attr.value
взамен. isSupported()
- Вы не должны были использовать это в первую очередь, поэтому вам, вероятно, все равно, что это больше не используется.
isEqualNode()
- Вы не должны были использовать это в первую очередь, поэтому вам, вероятно, все равно, что это больше не используется.
normalize()
- Вы не должны были использовать это в первую очередь, поэтому вам, вероятно, все равно, что это больше не используется.
removeAttributeNode()
- Используйте
Element.removeAttribute()
взамен. removeChild()
Вышла из употребления с версии Gecko 14- Измените значение
Attr.value
взамен.. replaceChild()
Вышла из употребления с версии Gecko 14- Modify the value of
Attr.value
взамен. setAttributeNode()
- Используйте
Element.setAttribute()
взамен. setAttributeNodeNS()
- Используйте
Element.setAttributeNS()
взамен.
Спецификации
Specification | Status | Comment |
---|---|---|
DOM Определение 'Attr' в этой спецификации. |
Живой стандарт | Added ownerElement property back |
DOM4 Определение 'Attr' в этой спецификации. |
Устаревшая | Moved namespaceURI , prefix and localName from Node to this API and removed ownerElement , schemaTypeInfo and isId . |
Document Object Model (DOM) Level 3 Core Specification Определение 'Attr' в этой спецификации. |
Устаревшая | Initial definition |
Поддержка браузерами
Feature | Chrome | Edge | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|---|
Базовая поддержка | (Да)[1] | (Да) | (Да) | (Да) | (Да) | (Да) |
Feature | Android | Android Webview | Edge | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile | Chrome for Android |
---|---|---|---|---|---|---|---|---|
Базовая поддержка | (Да) | (Да)[1] | (Да) | (Да) | (Да) | (Да) | (Да) | (Да)[1] |
[1] Начиная с Chrome 45, это свойство больше не наследуется от Node.