XML DOM Объект Элемент – Свойства и Методы

Рубрика: DOM - Объектная Модель Документа

Здравствуйте, уважаемые посетители okITgo.ru! Небольшая справочная статья по XML DOM объекту Элемент, перечислены все свойства объекта Элемент, а также методы объекта Элемент с кратким описанием, для чего они нужны и как используются (в дальнейшем я подробнее напишу о каждом свойстве / методе Элемента, а в этом посте расставлю ссылки на детальное описание).


Объект Элемент

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

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

Поскольку объект Элемент также является Узлом, он наследует свойства и методы объекта Узел.

Обозначения IE: Internet Explorer, F: Firefox, O: Opera, W3C: Консорциум Всемирной Паутины (Интернет Стандарт)

Свойства Объекта Элемент

Свойство Описание IE F O W3C
attributes Возвращает Именованную Карту Узлов атрибутов для элемента 5 1 9 Да
baseURI Returns the absolute base URI of the element Нет 1 Нет Да
childNodes Возвращает Список дочерних Узлов элемента 5 1 9 Да
firstChild Возвращает первого сына элемента 5 1 9 Да
lastChild Возвращает последнего сына элемента 5 1 9 Да
localName Возвращает локальную часть имени элемента Нет 1 9 Да
namespaceURI Возвращает URI пространства имен элемента Нет 1 9 Да
nextSibling Возвращает узел, непосредственно следующий за элементом 5 1 9 Да
nodeName Возвращает имя узла в зависимости от его типа 5 1 9 Да
nodeType Возвращает тип узла 5 1 9 Да
ownerDocument Возвращает корневой элемент (объект документ) для элемента 5 1 9 Да
parentNode Возвращает родительский узел элемента 5 1 9 Да
prefix Устанавливает или возвращает префикс пространства имен элемента Нет 1 9 Да
previousSibling Возвращает узел, следующий непосредственно перед элементом 5 1 9 Да
schemaTypeInfo Возвращает информацию типа, связанную с элементом     Нет Да
tagName Возвращает имя элемента 5 1 9 Да
textContent Устанавливает или возвращает текстовое содержимое элемента и его потомков Нет 1 Нет Да
text Возвращает текст узла и его потомков. Работает только в IE 5 Нет Нет Нет
xml Возвращает содержимое узла и его потомков в виде XML данных. Работает только в IE 5 Нет Нет Нет

Методы Объекта Элемент

Метод Описание IE F O W3C
appendChild() Добавляет новый дочерний узел в конец списка детей узла 5 1 9 Да
cloneNode() Клонирует узел 5 1 9 Да
compareDocumentPosition() Сравнивает положение в документе двух узлов Нет 1 Нет Да
getAttribute() Возвращает значение атрибута 5 1 9 Да
getAttributeNS() Возвращает значение атрибута ( с пространством имен) Нет 1 9 Да
getAttributeNode() Возвращает узел атрибута в виде объекта Атрибут 5 1 9 Да
getAttributeNodeNS() Возвращает узел атрибута (с пространством имен) в виде объекта Атрибут Нет   9 Да
getElementsByTagName() Возвращает Список Узлов соответствующих узлов элементов, и их детей 5 1 9 Да
getElementsByTagNameNS() Возвращает Список Узлов элементов с указанным именем (с пространством имен), и их детей Нет 1 9 Да
getFeature(feature,version) Возвращает DOM объект, который реализует специализированные интерфейсы API указанной функции и версии     Нет Да
getUserData(key) Возвращает объект, ассоциированный с ключем на этом узле. Объект должен быть предварительно установлен для этого узла вызовом setUserData с тем же ключем     Нет Да
hasAttribute() Определяет, имеет ли элемент какие-либо атрибуты, соответствующие указанному имени 5 1 9 Да
hasAttributeNS() Определяет, имеет ли элемент какие-либо атрибуты, соответствующие указанным имени и пространству имен Нет 1 9 Да
hasAttributes() Определяет, имеет ли элемент хоть один атрибут 5 1 9 Да
hasChildNodes() Определяет, имеет ли элемент дочерние узлы 5 1 9 Да
insertBefore() Вставляет новый дочерний узел перед существующим дочерним узлом 5 1 9 Да
isDefaultNamespace(URI) Определяет, является ли указанное посредством URI пространство имен – простанством имен по умолчанию     Нет Да
isEqualNode() Проверка, равны ли два узла Нет Нет Нет Да
isSameNode() Проверка, являются ли два узла одним и тем же узлом Нет 1 Нет Да
isSupported(feature,version) Определяет, поддерживается ли указанная функция элементом     9 Да
lookupNamespaceURI() Возвращает URI пространства имен, соответствующего указанному префиксу Нет 1 Нет Да
lookupPrefix() Возвращает префикс, соответствующий указанному URI пространства имен Нет 1 Нет Да
normalize() Преобразует все текстовые узлы под этим элементом (включая атрибуты) в "нормальную" форму, где только структура документа (например, элементы, комментарии, инструкции обработки, секции CDATA и ссылки сущностей) разеляют Текстовые узлы, т.е. не остается смежных текстовых узлов, или пустых текстовых узлов 5 1 9 Да
removeAttribute() Удаляет указанный атрибут 5 1 9 Да
removeAttributeNS() Удаляет указанный атрибут (с пространством имен) Нет 1 9 Да
removeAttributeNode() Удаляет указанный узел атрибута 5 1 9 Да
removeChild() Удаляет дочерний узел 5 1 9 Да
replaceChild() Заменяет дочерний узел 5 1 9 Да
setUserData(key,data,handler) Ассоциирует объект с ключем элемента     Нет Да
setAttribute() Добавляет новый атрибут 5 1 9 Да
setAttributeNS() Добавляет новый атрибут (с пространством имен)   1 9 Да
setAttributeNode() Добавляет новый атрибутивный узел 5 1 9 Да
setAttributeNodeNS(attrnode) Добавляет новый атрибутивный узел (с пространством имен)     9 Да
setIdAttribute(name,isId) Если свойство isId объекта Атрибут равно true, этот метод объявляет указанный атрибут пользовательским ID атрибутом     Нет Да
setIdAttributeNS(uri,name,isId) Если свойство isId объекта Атрибут установлено в true, этот метод объявляет указанный атрибут (с пространством имен) пользовательским (т.е. определенным пользователем) ID атрибутом     Нет Да
setIdAttributeNode(idAttr,isId) Если свойство isId объекта Атрибут равно true, этот метод объявляет указанный атрибут пользовательским ID атрибутом     Нет Да

В дальнейшем, как уже упоминал в начале статьи, я планирую подробнее описать каждое из вышеперечисленных свойств / методов объекта Элемент, и на примерах показать их использование (подписаться на обновления сайта по RSS / E-Mail). Удачи Вам и до новых встреч на страницах блога okITgo.ru.

Обсуждение закрыто.