Объект Element XML DOM
- Предыдущая страница DOM Document
- Следующая страница DOM Attr
Объект 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, то этот метод объявляет указанный атрибут как пользовательский确定的 идентификационный атрибут. |
- Предыдущая страница DOM Document
- Следующая страница DOM Attr