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

Объект XmlElement

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

наследование

Атрибут члена

namespaceURI

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

1
readonly String XmlElement.namespaceURI;

prefix

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

1
String XmlElement.prefix;

localName

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

1
readonly String XmlElement.localName;

tagName

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

1
readonly String XmlElement.tagName;

id

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

1
String XmlElement.id;

textContent

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

1
String XmlElement.textContent;

innerHTML

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

1
String XmlElement.innerHTML;

className

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

1
String XmlElement.className;

attributes

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

1
readonly XmlNamedNodeMap XmlElement.attributes;

nodeType

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

1
readonly Integer XmlElement.nodeType;

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


nodeName

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

1
readonly String XmlElement.nodeName;

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


nodeValue

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

1
String XmlElement.nodeValue;

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


ownerDocument

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

1
readonly XmlDocument XmlElement.ownerDocument;

parentNode

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

1
readonly XmlNode XmlElement.parentNode;

childNodes

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

1
readonly XmlNodeList XmlElement.childNodes;

firstChild

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

1
readonly XmlNode XmlElement.firstChild;

lastChild

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

1
readonly XmlNode XmlElement.lastChild;

previousSibling

XmlNode , возвращает узел непосредственно перед узлом (на том же уровне дерева), если такого узла нет, то это свойство возвращает нуль

1
readonly XmlNode XmlElement.previousSibling;

nextSibling

XmlNode , возвращает узел сразу после элемента (на том же уровне дерева), если такого узла нет, атрибут возвращает ноль

1
readonly XmlNode XmlElement.nextSibling;

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

getAttribute

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

1
String XmlElement.getAttribute(String name);

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

  • name : String, укажите имя атрибута запроса

Вернуть результат:

  • String , вернуть значение свойства

getAttributeNS

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

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

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

  • namespaceURI : String, указывает URI пространства имен запроса
  • localName : String, указывает имя атрибута запроса

Вернуть результат:

  • String , вернуть значение свойства

setAttribute

Создать или изменить новый атрибут

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

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

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

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


setAttributeNS

Создать или изменить атрибуты с пространством имен

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

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

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

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


removeAttribute

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

1
XmlElement.removeAttribute(String name);

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

  • name : String, укажите имя удаленного атрибута

removeAttributeNS

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

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

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

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

hasAttribute

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

1
Boolean XmlElement.hasAttribute(String name);

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

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

Вернуть результат:

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

hasAttributeNS

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

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

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

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

Вернуть результат:

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

getElementsByTagName

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

1
XmlNodeList XmlElement.getElementsByTagName(String tagName);

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

  • tagName : String, имя тега для извлечения. Значение "*" соответствует всем тегам

Вернуть результат:

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

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

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


getElementsByTagNameNS

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

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

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

  • namespaceURI : String, указывает URI пространства имен для запроса
  • localName : String, имя тега для извлечения. Значение "*" соответствует всем тегам

Вернуть результат:

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

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


getElementById

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

1
XmlElement XmlElement.getElementById(String id);

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

  • id : строка, идентификатор для получения

Вернуть результат:

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

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

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


getElementsByClassName

Возврат списка узлов со всеми элементами указанного имени класса

1
XmlNodeList XmlElement.getElementsByClassName(String className);

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

  • className : String, имя класса для извлечения

Вернуть результат:

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

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


hasChildNodes

Проверьте, есть ли дочерний узел

1
Boolean XmlElement.hasChildNodes();

Вернуть результат:

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

normalize

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

1
XmlElement.normalize();

Этот метод будет перебирать всех потомков текущего узла, удаляя пустой текстовый узел, объединив все смежные текстовые узлы для нормализации документа. Этот метод полезен для упрощения структуры дерева документа после вставки или удаления узлов.


cloneNode

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

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

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

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

Вернуть результат:

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

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


lookupPrefix

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

1
String XmlElement.lookupPrefix(String namespaceURI);

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

  • namespaceURI : String, указывает соответствующий 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 , вернуть новый дочерний узел

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


appendChild

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

1
XmlNode XmlElement.appendChild(XmlNode newChild);

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

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

Вернуть результат:

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

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


replaceChild

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

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

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

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

Вернуть результат:

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

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


removeChild

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

1
XmlNode XmlElement.removeChild(XmlNode oldChild);

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

  • oldChild : XmlNode , укажите удаляемый узел

Вернуть результат:

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

toString

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

1
String XmlElement.toString();

Вернуть результат:

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

toJSON

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

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

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

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

Вернуть результат:

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