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

Объект XmlElement

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

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

#lineWidth: 1.5 #font: Helvetica,sans-Serif #fontSize: 10 #leading: 1.6 #.this: fill=lightgray #.class: fill=white [<class>object|toString();toJSON()] [<class>XmlNode|nodeType;nodeName;nodeValue;ownerDocument;parentNode;childNodes;firstChild;lastChild;previousSibling;nextSibling|hasChildNodes();normalize();cloneNode();lookupPrefix();lookupNamespaceURI();insertBefore();insertAfter();appendChild();replaceChild();removeChild()] [<this>XmlElement|namespaceURI;prefix;localName;tagName;id;textContent;innerHTML;className;attributes|getAttribute();getAttributeNS();setAttribute();setAttributeNS();removeAttribute();removeAttributeNS();hasAttribute();hasAttributeNS();getElementsByTagName();getElementsByTagNameNS();getElementById();getElementsByClassName()] [object] <:- [XmlNode] [XmlNode] <:- [XmlElement] XmlNode nodeType nodeName nodeValue ownerDocument parentNode childNodes firstChild lastChild previousSibling nextSibling hasChildNodes() normalize() cloneNode() lookupPrefix() lookupNamespaceURI() insertBefore() insertAfter() appendChild() replaceChild() removeChild() XmlElement namespaceURI prefix localName tagName id textContent innerHTML className attributes getAttribute() getAttributeNS() setAttribute() setAttributeNS() removeAttribute() removeAttributeNS() hasAttribute() hasAttributeNS() getElementsByTagName() getElementsByTagNameNS() getElementById() getElementsByClassName() object toString() toJSON()

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

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

1
readonly XmlNode XmlElement.previousSibling;

nextSibling

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

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, Узла XmlElement с указанной меткой в ​​дереве узлов XmlNodeListсобирать. Порядок возвращаемых узлов элементов - это порядок, в котором они появляются в исходном документе.

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

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


getElementsByTagNameNS

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

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

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

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

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

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

Этот метод похож на метод 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, Узел XmlElement с указанным именем класса в дереве документа XmlNodeListсобирать. Порядок возвращаемых узлов элементов - это порядок, в котором они появляются в исходном документе.

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


hasChildNodes

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

1
Boolean XmlElement.hasChildNodes();

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

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

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 пространства имен, возвращает ноль, если он не совпадает

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

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


removeChild

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

1
XmlNode XmlElement.removeChild(XmlNode oldChild);

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

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

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

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

toString

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

1
String XmlElement.toString();

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

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

toJSON

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

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

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

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

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

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