XML DOM - ElementОбъект
Объект Element
Объект Element представляет элемент в XML-документе. Элементы могут содержать атрибуты, другие элементы или текст. Если элемент содержит текст, этот текст представлен в текстовом узле.
Важно:Текст всегда хранится в текстовых узлах. Распространённая ошибка при обработке DOM — переход к узлу элемента и предположение, что этот узел содержит текст. Однако даже у простейшего узла элемента под ним есть текстовый узел. Например, в <year>2005</year> есть узел элемента (year), а под этим узлом находится текстовый узел, содержащий текст (2005).
Поскольку объект Element также является узлом, он может наследовать свойства и методы объекта Node.
Свойства объекта Element
| Свойство | Описание |
|---|---|
| attributes | Возвращает NamedNodeMap атрибутов элемента. |
| baseURI | Возвращает абсолютный базовый URI элемента. |
| childNodes | Возвращает NodeList дочерних узлов элемента. |
| firstChild | Возвращает первый дочерний узел элемента. |
| lastChild | Возвращает последний дочерний узел элемента. |
| localName | Возвращает локальную часть имени элемента. |
| namespaceURI | Возвращает URI пространства имен элемента. |
| nextSibling | Возвращает узел, непосредственно следующий за элементом. |
| nodeName | Возвращает имя узла в зависимости от его типа. |
| nodeType | Возвращает тип узла. |
| ownerDocument | Возвращает корневой элемент (объект document), которому принадлежит элемент. |
| parentNode | Возвращает родительский узел элемента. |
| префикс | Задает или возвращает префикс пространства имен элемента. |
| 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() | Проверяет, равны ли два узла. |
| isSameNode() | Проверяет, являются ли два узла одним и тем же узлом. |
| isSupported(feature,version) | Возвращает значение, указывающее, поддерживается ли указанная возможность в этом элементе. |
| lookupNamespaceURI() | Возвращает URI пространства имён, соответствующий указанному префиксу. |
| lookupPrefix() | Возвращает префикс, соответствующий указанному URI пространства имён. |
| normalize() | Приводит все текстовые узлы под узлом (включая атрибуты) к «нормальной» форме, где только структура (такая как элементы, комментарии, инструкции обработки, секции CDATA и ссылки на сущности) разделяет текстовые узлы; например, не существует ни смежных текстовых узлов, ни пустых текстовых узлов. |
| removeAttribute() | Удаляет указанный атрибут. |
| removeAttributeNS() | Удаляет указанный атрибут (с пространством имён). |
| removeAttributeNode() | Удаляет указанный узел атрибута. |
| removeChild() | Удаляет дочерний узел. |
| replaceChild() | Заменить дочерний узел. |
| setUserData(key,data,handler) | Связывает объект с ключом на элементе. |
| setAttribute() | Добавить новый атрибут. |
| setAttributeNS() | Добавляет новый атрибут (с пространством имён). |
| setAttributeNode() | Добавляет новый узел атрибута. |
| setAttributeNodeNS(attrnode) | Добавляет новый узел атрибута (с пространством имён). |
| setIdAttribute(name,isId) | Если свойство isId объекта Attribute равно true, этот метод объявляет указанный атрибут атрибутом ID, определяемым пользователем. |
| setIdAttributeNS(uri,name,isId) | Если свойство isId объекта Attribute равно true, этот метод объявляет указанный атрибут атрибутом ID, определяемым пользователем (с пространством имён). |
| setIdAttributeNode(idAttr,isId) | Если свойство isId объекта Attribute равно true, этот метод объявляет указанный атрибут атрибутом ID, определяемым пользователем. |
Другие расширения