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

Объект 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;

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


nodeName

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

1
readonly String XmlElement.nodeName;

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


nodeValue

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

1
String XmlElement.nodeValue;

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


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 , возвращает узел непосредственно перед узлом (на том же уровне дерева), если такого узла нет, то это свойство возвращает null

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 : строка, укажите имя атрибута, который необходимо установить
  • 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();

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


cloneNode

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

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

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

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

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

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

Этот метод скопирует и вернет копию вызвавшего его узла. Если переданный ему параметр - истина, он также будет рекурсивно копировать всех потомков текущего узла. В противном случае копируется только текущий узел. Возвращенный узел не принадлежит дереву документа, а его свойство 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, укажите соответствующий префикс

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

  • 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 , если замена прошла успешно, этот метод может вернуть замененный узел, если замена не удалась, он возвращает null

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


removeChild

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

1
XmlNode XmlElement.removeChild(XmlNode oldChild);

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

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

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

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

toString

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

1
String XmlElement.toString();

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

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

toJSON

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

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

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

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

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

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