Объект Element XML DOM

Объект Element

Объект Element представляет элемент в XML-документе. Элемент может содержать атрибуты, другие элементы или текст. Если элемент содержит текст, то этот текст будет представлен в узле текста.

Важно:Текст всегда хранится в узле текста. Одна из наиболее частых ошибок при обработке DOM заключается в том, что пользователь перемещается к узлу элемента и думает, что этот узел содержит текст. Однако, даже у самых простых узлов элемента underneath есть узлы текста, содержащие текст. Например, в <year>2005</year> есть узел элемента (year), и под этим узлом есть узел текста, содержащий текст (2005).

Поскольку объект Element также является узлом, он может наследовать атрибуты и методы объекта Node.

Атрибуты объекта Element

атрибуты Описание
attributes Возвращает атрибуты элемента в виде NamedNodeMap.
baseURI Возврат абсолютного базового URI элемента.
childNodes Возврат NodeList подузлов элемента.
firstChild Возврат первого подузла элемента.
lastChild Возврат последнего подузла элемента.
localName Возврат локальной части имени элемента.
namespaceURI Возврат URI命名ного пространства элемента.
nextSibling Возврат узла, который находится сразу после этого элемента.
nodeName Возврат имени узла, в зависимости от его типа.
nodeType Возврат типа узла.
ownerDocument Возврат корневого элемента (документа).
parentNode Возврат родительского узла элемента.
prefix Установка или возврат префикса命名ного пространства элемента.
previousSibling Возврат узла, который находится сразу перед этим элементом.
schemaTypeInfo Возврат типа информации, связанной с элементом.
tagName Возврат имени элемента.
textContent Установка или возврат текстового содержимого элемента и его потомков.

Методы объекта Element

Метод Описание
appendChild() Добавление нового подузла в конец списка подузлов этого узла.
cloneNode() Клонирование узла.
compareDocumentPosition() Сравнение документного положения двух узлов.
getAttribute() Возврат значения атрибута.
getAttributeNS() Возврат значения атрибута (с именем пространства имен).
getAttributeNode() Возврат узла атрибута в виде объекта Attribute.
getAttributeNodeNS() Возврат узла атрибута (с именем пространства имен) в виде объекта Attribute.
getElementsByTagName() Возврат NodeList с узлами элементов, соответствующими заданному имени, и их подузлами.
getElementsByTagNameNS() Возврат NodeList с узлами элементов, соответствующими заданному имени, и их подузлами (с именем пространства имен).
getFeature()feature,version) Возврат DOM-объекта, который реализует专用 API для указанных свойств и версий.
getUserData()key) Возврат объекта, связанного с ключом на этом узле. Сначала объект необходимо установить на этот узел, используя метод setUserData с тем же ключом.
hasAttribute() Возврат элемента, имеет ли атрибут с указанным именем.
hasAttributeNS() Вернуть, имеет ли элемент атрибут с указанным именем и пространством имен.
hasAttributes() Вернуть, имеет ли элемент атрибуты.
hasChildNodes() Вернуть, имеет ли элемент подузлы.
insertBefore() Вставить новый подузел перед существующими подузлами.
isDefaultNamespace(URI) Вернуть, является ли указанный namespaceURI доменным.
isEqualNode() Проверить, равны ли два узла.
lookupNamespaceURI() Вернуть URI пространства имен, соответствующий указанному префиксу.
lookupPrefix() Вернуть префикс, соответствующий указанному URI пространства имен.
normalize()

Метод normalize() удаляет пустые текстовые узлы и соединяет смежные текстовые узлы.

Регуляризировать все текстовые узлы под элементом (включая атрибуты), где текстовые узлы разделены только структурой (например, элементами, комментариями, директивами обработки, частями CDATA и ссылками на сущности).

То есть, не существует смежных текстовых узлов и пустых текстовых узлов.

removeAttribute() Удалить указанный атрибут.
removeAttributeNS() Удалить указанный атрибут (с пространством имен).
removeAttributeNode() Удалить указанный атрибутный узел.
removeChild() Удалить подузел.
replaceChild() Заменить подузел.
setUserData(key,data,handler) Связать объект с ключом на элементе.
setAttribute() Добавить новый атрибут.
setAttributeNS() Добавить новый атрибут (с пространством имен).
setAttributeNode() Добавить новый атрибутный узел.
setAttributeNodeNS(attrnode) Добавить новый атрибутный узел (с пространством имен).
setIdAttribute(name,isId) Если атрибут объекта isId равен true, то этот метод объявляет указанный атрибут как пользовательский确定的 идентификационный атрибут.
setIdAttributeNS(uri,name,isId) Если атрибут объекта isId равен true, то этот метод объявляет указанный атрибут (с пространством имен) как пользовательский确定的 идентификационный атрибут.
setIdAttributeNode(idAttr,isId) Если атрибут объекта isId равен true, то этот метод объявляет указанный атрибут как пользовательский确定的 идентификационный атрибут.