ОбъектXmlElement

Объекты XmlElement представляют элементы в XML-документе.

отношения наследства

свойства члена

namespaceURI

Строка, URI пространства имен элемента запроса. Если выбранный узел не имеет пространства имен, это свойство возвращает NULL.

1
readonly String XmlElement.namespaceURI;

prefix

Строка, запрос и установка префикса пространства имен элемента. Если выбранный узел не имеет пространства имен, это свойство возвращает NULL.

1
String XmlElement.prefix;

localName

Строка, локальное имя элемента запроса. Если выбранный узел не имеет пространства имен, это свойство эквивалентно nodeName.

1
readonly String XmlElement.localName;

tagName

Строка, возвращает имя тега элемента.

1
readonly String XmlElement.tagName;

id

Строка, запрос и установка атрибута id элемента.

1
String XmlElement.id;

innerHTML

Строка, запрос и установка HTML-текста потомков выбранного элемента, допустимого только в режиме HTML. При запросе возвращает кодировку HTML всех дочерних узлов внутри узла элемента; при настройке удаляет все дочерние узлы и заменяет их указанным декодированием HTML.

1
String XmlElement.innerHTML;

outerHTML

Строка, запрос HTML-текста выбранного элемента и его потомков, допустима только в режиме HTML. При запросе возвращайте HTML-кодировку элемента и всех дочерних узлов внутри узла.

1
readonly String XmlElement.outerHTML;

className

Строка, запрос и установка атрибута класса элемента, допустимо только в режиме html.

1
String XmlElement.className;

attributes

XmlNamedNodeMap, возвращает NamedNodeMap, содержащий атрибуты выбранного узла. Если выбранный узел не является элементом, это свойство возвращает NULL.

1readonly XmlNamedNodeMap XmlElement.attributes;

nodeType

Целое число, возвращает тип узла.

1readonly Integer XmlElement.nodeType;

NodeType разных объектов будет возвращать разные значения:

XmlElement: ELEMENT_NODE(1)
XmlAttr:ATTRIBUTE_NODE(2)
XmlText: TEXT_NODE(3)
XmlCDATASection: CDATA_SECTION_NODE(4)
XmlProcessingInstruction: PROCESSING_INSTRUCTION_NODE(7)
XmlComment:COMMENT_NODE(8)
XmlDocument: ДОКУМЕНТ_НОД(9)
XmlDocumentType: DOCUMENT_TYPE_NODE(10)

nodeName

Строка, возвращает имя узла в соответствии с его типом.

1
readonly String XmlElement.nodeName;

Имя узла разных объектов будет возвращать разные значения:

XmlElement:имя элемента
XmlAttr: имя атрибута
XmlText: #текст
XmlCDATASection: #cdata-раздел
XmlProcessingInstruction: Возвращает указанную целевую цель
XmlComment: #комментарий
XmlDocument: #документ
XmlDocumentType: имя типа документа

nodeValue

Строка, возвращает имя узла в соответствии с его типом.

1
String XmlElement.nodeValue;

Имя узла разных объектов будет возвращать разные значения:

XmlElement: нулевой
XmlAttr: значение атрибута
XmlText: содержимое узла
XmlCDATASection: содержимое узла
XmlProcessingInstruction: Возвращает указанные данные содержимого.
XmlComment: текст аннотации
XmlDocument: нулевой
XmlDocumentType: нулевой

ownerDocument

XmlDocument, возвращает корневой элемент узла (XmlDocumentобъект)

1readonly XmlDocument XmlElement.ownerDocument;

parentNode

XmlNode, может вернуть родительский узел узла

1readonly XmlNode XmlElement.parentNode;

childNodes

XmlNodeList, возвращает список дочерних узлов указанного узла

1readonly XmlNodeList XmlElement.childNodes;

children

XmlNodeList, возвращает список узлов дочерних элементов указанного узла.

1readonly XmlNodeList XmlElement.children;

firstChild

XmlNode, возвращает первый дочерний узел узла

1readonly XmlNode XmlElement.firstChild;

lastChild

XmlNode, возвращает последний дочерний узел узла

1readonly XmlNode XmlElement.lastChild;

previousSibling

XmlNode, возвращает узел, непосредственно предшествующий узлу (на том же уровне дерева). Если такого узла нет, то это свойство возвращает значение null.

1readonly XmlNode XmlElement.previousSibling;

nextSibling

XmlNode, возвращает узел, следующий сразу за элементом (на том же уровне дерева). Если такого узла нет, атрибут возвращает значение null.

1readonly XmlNode XmlElement.nextSibling;

firstElementChild

XmlNode, возвращает первый дочерний элемент узла узла

1readonly XmlNode XmlElement.firstElementChild;

lastElementChild

XmlNode, возвращает последний дочерний элемент узла узла

1readonly XmlNode XmlElement.lastElementChild;

previousElementSibling

XmlNode, возвращает узел элемента, непосредственно предшествующий узлу (на том же уровне дерева). Если такого узла нет, то это свойство возвращает значение null.

1readonly XmlNode XmlElement.previousElementSibling;

nextElementSibling

XmlNode, возвращает узел элемента, следующий сразу за элементом (на том же уровне дерева). Если такого узла нет, атрибут возвращает значение null.

1readonly XmlNode XmlElement.nextElementSibling;

textContent

Строка, запрашивает и устанавливает текст выбранного элемента. При запросе возвращает значения всех текстовых узлов внутри узла элемента; при установке удаляет все дочерние узлы и заменяет их одним текстовым узлом.

1
String XmlElement.textContent;

функция-член

getAttribute

Запросить значение атрибута по имени

1
String XmlElement.getAttribute(String name);

Параметры звонка:

name: строка, указывает имя атрибута запроса.

Результаты возврата:

String, возвращает значение атрибута

getAttributeNS

Получить значение атрибута по URI пространства имен и имени.

1
2
String XmlElement.getAttributeNS(String namespaceURI,
    String localName);

Параметры звонка:

namespaceURI: строка, определяющая URI пространства имен запроса.
localName: строка, указывает имя атрибута запроса.

Результаты возврата:

String, возвращает значение атрибута

setAttribute

Создать или изменить новое свойство

1
2
XmlElement.setAttribute(String name,
    String value);

Параметры звонка:

name: строка, указывает имя атрибута, который необходимо установить.
value: строка, указывает значение атрибута, которое необходимо установить.

Этот метод устанавливает указанное свойство в указанное значение. Если свойство с указанным именем не существует, этот метод создает новое свойство.

setAttributeNS

Создание или изменение свойств пространства имен

1
2
3
XmlElement.setAttributeNS(String namespaceURI,
    String qualifiedName,
    String value);

Параметры звонка:

namespaceURI: строка, указывает URI пространства имен, который необходимо установить.
qualifiedName: строка, указывает имя атрибута, который необходимо установить.
value: строка, указывает значение атрибута, которое необходимо установить.

Этот метод аналогичен методу setAttribute, за исключением того, что атрибут, который должен быть создан или установлен, указывается URI пространства имен и квалифицированным именем, состоящим из префикса пространства имен, двоеточия и локального имени в пространстве имен. Помимо изменения значения атрибута, вы также можете использовать этот метод для изменения префикса пространства имен атрибута.

removeAttribute

Удалить указанный атрибут по имени

1
XmlElement.removeAttribute(String name);

Параметры звонка:

name: строка, указывает имя удаляемого атрибута.

removeAttributeNS

Удалить указанные свойства по пространству имен и имени

1
2
XmlElement.removeAttributeNS(String namespaceURI,
    String localName);

Параметры звонка:

namespaceURI: строка, указывает URI пространства имен, которое необходимо удалить.
localName: строка, указывает имя удаляемого атрибута.

hasAttribute

Запросить, имеет ли текущий узел атрибут с указанным именем.

1
Boolean XmlElement.hasAttribute(String name);

Параметры звонка:

name: строка, указывает имя атрибута запроса.

Результаты возврата:

Boolean, если текущий узел элемента имеет указанный атрибут, возвращает true, в противном случае возвращает false

hasAttributeNS

Запросить, имеет ли текущий узел атрибуты с указанным пространством имен и именем.

1
2
Boolean XmlElement.hasAttributeNS(String namespaceURI,
    String localName);

Параметры звонка:

namespaceURI: строка, указывает URI пространства имен, который будет запрошен.
localName: строка, указывает имя атрибута запроса.

Результаты возврата:

Boolean, если текущий узел элемента имеет указанный атрибут, возвращает true, в противном случае возвращает false

getElementsByTagName

Возвращает все элементы с указанным именемXmlNodeList

1
XmlNodeList XmlElement.getElementsByTagName(String tagName);

Параметры звонка:

tagName: строка, имя тега, который необходимо получить. Значение «*» соответствует всем тегам

Результаты возврата:

XmlNodeList, узел XmlElement с указанным тегом в дереве узловXmlNodeListсобирать. Порядок возвращаемых узлов элементов — это порядок, в котором они появляются в исходном документе.

Этот метод будет проходить через узлы-потомки указанного элемента и возвращать узел XmlElement.XmlNodeListОбъект, представляющий все элементы документа с указанным именем тега. Порядок элементов в возвращаемом массиве соответствует порядку, в котором они появляются в исходном коде документа.

XmlDocumentИнтерфейс также определяет метод getElementsByTagName, который аналогичен этому методу, но обходит весь документ, а не просматривает узлы-потомки элемента.

getElementsByTagNameNS

Возвращает все элементы с указанным пространством имен и именем.XmlNodeList

1
2
XmlNodeList XmlElement.getElementsByTagNameNS(String namespaceURI,
    String localName);

Параметры звонка:

namespaceURI: строка, указывает URI пространства имен, который будет запрошен.
localName: строка, имя тега, который необходимо получить. Значение «*» соответствует всем тегам

Результаты возврата:

XmlNodeList, узел XmlElement с указанным тегом в дереве узловXmlNodeListсобирать. Порядок возвращаемых узлов элементов — это порядок, в котором они появляются в исходном документе.

Этот метод аналогичен методу getElementsByTagName, за исключением того, что имя тега элемента, который вы хотите получить, указывается как комбинация URI пространства имен и локального имени, определенного в пространстве имен.

getElementById

Возвращает элемент с указанным атрибутом id

1
XmlElement XmlElement.getElementById(String id);

Параметры звонка:

id: строка, идентификатор, который нужно получить.

Результаты возврата:

XmlElement, узел XmlElement с указанным атрибутом id в дереве узлов.

Этот метод будет проходить через узлы-потомки указанного элемента и возвращать объект узла XmlElement, представляющий первый элемент документа с указанным атрибутом id. .

getElementsByClassName

Возвращает список узлов всех элементов с указанным именем класса.

1
XmlNodeList XmlElement.getElementsByClassName(String className);

Параметры звонка:

className: строка, имя класса, которое нужно получить.

Результаты возврата:

XmlNodeList, узел XmlElement с указанным именем класса в дереве документаXmlNodeListсобирать. Порядок возвращаемых узлов элементов — это порядок, в котором они появляются в исходном документе.

Этот метод вернетXmlNodeListОбъект (может обрабатываться как массив, доступный только для чтения), в котором хранятся все узлы XmlElement с указанным именем класса в документе. Порядок их хранения соответствует порядку, в котором они появляются в исходном документе.XmlNodeListОбъект является «живым», то есть если в документе будет добавлен или удален элемент с указанным именем тега, его содержимое будет автоматически обновляться по мере необходимости.

hasChildNodes

Запросить, есть ли дочерние узлы

1
Boolean XmlElement.hasChildNodes();

Результаты возврата:

Boolean, возвращает true, если есть дочерние узлы, в противном случае возвращает false

normalize

Объединить соседние текстовые узлы и удалить пустые текстовые узлы.

1XmlElement.normalize();

Этот метод пройдет через все узлы-потомки текущего узла и нормализует документ, удалив пустые узлы Text и объединив все соседние узлы Text. Этот метод полезен для упрощения структуры дерева документа после вставки или удаления узлов.

cloneNode

Создает точную копию указанного узла

1
XmlNode XmlElement.cloneNode(Boolean deep = true);

Параметры звонка:

deep: логическое значение, следует ли выполнять глубокое копирование. Если установлено значение true, клонированный узел клонирует все дочерние узлы исходного узла.

Результаты возврата:

XmlNode, возвращает скопированный узел

Этот метод скопирует и вернет копию узла, на котором он был вызван. Если переданный ему аргумент верен, он также рекурсивно скопирует все узлы-потомки текущего узла. В противном случае он только копирует текущий узел. Возвращенный узел не принадлежит дереву документа, а его свойство родительский узел имеет значение null. При копировании узла Element будут скопированы все его свойства.

lookupPrefix

Возвращает префикс, соответствующий указанному URI пространства имен на текущем узле.

1
String XmlElement.lookupPrefix(String namespaceURI);

Параметры звонка:

namespaceURI: строка, указывает соответствующий URI пространства имен.

Результаты возврата:

String, возвращает соответствующий префикс, возвращает ноль, если не совпадает.

lookupNamespaceURI

Возвращает URI пространства имен, соответствующий указанному префиксу на текущем узле.

1
String XmlElement.lookupNamespaceURI(String prefix);

Параметры звонка:

prefix: строка, указывает соответствующий префикс.

Результаты возврата:

String, возвращает соответствующий URI пространства имен, возвращает значение null, если не совпадает.

insertBefore

Вставьте новый дочерний узел перед существующим дочерним узлом.

1
2
XmlNode XmlElement.insertBefore(XmlNode newChild,
    XmlNode refChild);

Параметры звонка:

newChild:XmlNode, вставить новый узел
refChild:XmlNode, вставьте новый узел перед этим узлом

Результаты возврата:

XmlNode, возвращает новый дочерний узел

Если newChild уже существует в дереве документов, он будет удален из дерева документов и повторно вставлен в новую позицию. Узлы из одного документа (или узлы, созданные одним документом) не могут быть вставлены в другой документ. То есть атрибут OwnerDocument объекта newChild должен совпадать с атрибутом OwnerDocument текущего узла.

insertAfter

Вставьте новый дочерний узел после существующего дочернего узла.

1
2
XmlNode XmlElement.insertAfter(XmlNode newChild,
    XmlNode refChild);

Параметры звонка:

newChild:XmlNode, вставить новый узел
refChild:XmlNode, вставьте новый узел после этого узла

Результаты возврата:

XmlNode, возвращает новый дочерний узел

appendChild

Добавляет новый дочерний узел в конец списка дочерних узлов узла.

1XmlNode XmlElement.appendChild(XmlNode newChild);

Параметры звонка:

newChild:XmlNode, укажите добавленный узел

Результаты возврата:

XmlNode, возвращает этот новый дочерний узел

replaceChild

Заменить дочерний узел другим

1
2
XmlNode XmlElement.replaceChild(XmlNode newChild,
    XmlNode oldChild);

Параметры звонка:

newChild:XmlNode, укажите новый узел
oldChild:XmlNode, указывает узел, который будет заменен

Результаты возврата:

XmlNode, Если замена прошла успешно, этот метод может вернуть замененный узел. Если замена не удалась, он возвращает значение null.

removeChild

Удалить узел из списка дочерних узлов

1XmlNode XmlElement.removeChild(XmlNode oldChild);

Параметры звонка:

oldChild:XmlNode, указывает узел, который нужно удалить

Результаты возврата:

XmlNode, Если удаление прошло успешно, этот метод может вернуть удаленный узел. В случае неудачи он возвращает значение null.

toString

Возвращает строковое представление объекта. Обычно возвращается «[Native Object]». Объект может быть повторно реализован в соответствии с его собственными характеристиками.

1
String XmlElement.toString();

Результаты возврата:

String, возвращает строковое представление объекта

toJSON

Возвращает представление объекта в формате JSON, обычно возвращая коллекцию читаемых свойств, определенных объектом.

1
Value XmlElement.toJSON(String key = "");

Параметры звонка:

key: Строка, не используется.

Результаты возврата:

Value, возвращает значение, содержащее сериализуемый JSON

Руководство по разработке

Базовый модуль

встроенные объекты

модуль сообщества

ОбъектXmlElement

отношения наследства

свойства члена

namespaceURI

prefix

localName

tagName

id

innerHTML

outerHTML

className

attributes

nodeType

nodeName

nodeValue

ownerDocument

parentNode

childNodes

children

firstChild

lastChild

previousSibling

nextSibling

firstElementChild

lastElementChild

previousElementSibling

nextElementSibling

textContent

функция-член

getAttribute

getAttributeNS

setAttribute

setAttributeNS

removeAttribute

removeAttributeNS

hasAttribute

hasAttributeNS

getElementsByTagName

getElementsByTagNameNS

getElementById

getElementsByClassName

hasChildNodes

normalize

cloneNode

lookupPrefix

lookupNamespaceURI

insertBefore

insertAfter

appendChild

replaceChild

removeChild

toString

toJSON