Object XmlElement

XmlElement objects represent elements in XML documents

Inheritance

Member attributes

namespaceURI

String, the URI of the namespace of the query element. If the selected node has no namespace, this attribute returns NULL

1
readonly String XmlElement.namespaceURI;

prefix

String, query and set the namespace prefix of the element. If the selected node has no namespace, this attribute returns NULL

1
String XmlElement.prefix;

localName

String, the local name of the query element. If the selected node has no namespace, this attribute is equivalent to nodeName

1
readonly String XmlElement.localName;

tagName

String, returns the tag name of the element

1
readonly String XmlElement.tagName;

id

String, query and set the id attribute of the element

1
String XmlElement.id;

textContent

String, query and set the text of the selected element. When querying, return the values ​​of all text nodes in the element node; when setting, delete all child nodes and replace them with a single text node.

1
String XmlElement.textContent;

innerHTML

String, query and set the HTML text of the selected element, only valid in html mode. When querying, return the HTML codes of all child nodes in the element node; when setting, delete all child nodes and replace them with the specified HTML after decoding.

1
String XmlElement.innerHTML;

className

String, query and set the class attribute of the element, only valid in html mode

1
String XmlElement.className;

attributes

XmlNamedNodeMap , returns the NamedNodeMap containing the attributes of the selected node. If the selected node is not an element, this attribute returns NULL.

1
readonly XmlNamedNodeMap XmlElement.attributes;

nodeType

Integer, returns the node type of the node

1
readonly Integer XmlElement.nodeType;

The nodeType of different objects will return different values:

• 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 : DOCUMENT_NODE(9)
• XmlDocumentType : DOCUMENT_TYPE_NODE(10)

nodeName

String, returns the name of the node, according to its type

1
readonly String XmlElement.nodeName;

The nodeName of different objects will return different values:

• XmlElement : element name
• XmlAttr : attribute name
• XmlText : #text
• XmlCDATASection : #cdata-section
• XmlProcessingInstruction : Return the specified target target
• XmlComment : #comment
• XmlDocument : #document
• XmlDocumentType : doctype name

nodeValue

String, returns the name of the node, according to its type

1
String XmlElement.nodeValue;

The nodeName of different objects will return different values:

• XmlElement : null
• XmlAttr : the value of the attribute
• XmlText : the content of the node
• XmlCDATASection : the content of the node
• XmlProcessingInstruction : Return the specified content data
• XmlComment : comment text
• XmlDocument : null
• XmlDocumentType : null

ownerDocument

XmlDocument , returns the root element of the node ( XmlDocument object)

1
readonly XmlDocument XmlElement.ownerDocument;

parentNode

XmlNode , can return the parent node of a node

1
readonly XmlNode XmlElement.parentNode;

childNodes

XmlNodeList , returns the node list of the child nodes of the specified node

1
readonly XmlNodeList XmlElement.childNodes;

firstChild

XmlNode , returns the first child node of the node

1
readonly XmlNode XmlElement.firstChild;

lastChild

XmlNode , returns the last child node of the node

1
readonly XmlNode XmlElement.lastChild;

previousSibling

XmlNode , returns the node immediately before a node (at the same tree level), if there is no such node, then this property returns null

1
readonly XmlNode XmlElement.previousSibling;

nextSibling

XmlNode , returns the node immediately following an element (in the same tree level), if there is no such node, the attribute returns null

1
readonly XmlNode XmlElement.nextSibling;

Member function

getAttribute

Query the value of an attribute by name

1
String XmlElement.getAttribute(String name);

Call parameters:

• name : String, specify the attribute name of the query

Return result:

• String , returns the value of the property

getAttributeNS

Get attribute value by namespace URI and name

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

Call parameters:

• namespaceURI : String, specify the namespace URI of the query
• localName : String, specifies the name of the property to query

Return result:

• String , returns the value of the property

setAttribute

Create or change a new property

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

Call parameters:

• name : String, specify the name of the property to be set
• value : String, specify the attribute value to be set

This method sets the specified attribute to the specified value. If there is no attribute with the specified name, the method will create a new attribute

setAttributeNS

Create or change attributes with namespace

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

Call parameters:

• namespaceURI : String, specify the namespace URI to be set
• qualifiedName : String, specify the attribute name to be set
• value : String, specify the attribute value to be set

This method is similar to the setAttribute method, except that the attribute to be created or set is specified by the namespace URI and the qualified name (consisting of the namespace prefix, colon, and local name in the namespace). In addition to changing the value of an attribute, using this method can also change the namespace prefix of the attribute

removeAttribute

Delete the specified attribute by name

1
XmlElement.removeAttribute(String name);

Call parameters:

• name : String, specify the name of the deleted attribute

removeAttributeNS

Delete specified attributes by namespace and name

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

Call parameters:

• namespaceURI : String, specify the namespace URI to be deleted
• localName : String, specify the name of the deleted attribute

hasAttribute

Query whether the current node has an attribute with the specified name

1
Boolean XmlElement.hasAttribute(String name);

Call parameters:

• name : String, specify the name of the query attribute

Return result:

• Boolean , if the current element node has the specified attribute, return true, otherwise return false

hasAttributeNS

Query whether the current node has attributes of the specified namespace and name

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

Call parameters:

• namespaceURI : String, specify the namespace URI to be queried
• localName : String, specify the query attribute name

Return result:

• Boolean , if the current element node has the specified attribute, return true, otherwise return false

getElementsByTagName

Returns an XmlNodeList of all elements with the specified name

1
XmlNodeList XmlElement.getElementsByTagName(String tagName);

Call parameters:

• tagName : String, the name of the tag to be retrieved. The value "*" matches all tags

Return result:

• XmlNodeList , an XmlNodeList collection of XmlElement nodes with specified tags in the node tree. The order of returned element nodes is the order in which they appear in the source document.

This method will traverse the descendant nodes of the specified element and return an XmlNodeList object of XmlElement node, representing all document elements with the specified tag name. The order of the elements in the returned array is the order in which they appear in the document source code.

XmlDocument interface also defines the getElementsByTagName method, which is similar to this method, but traverses the entire document instead of traversing the descendants of an element.

getElementsByTagNameNS

Returns an XmlNodeList of all elements with the specified namespace and name

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

Call parameters:

• namespaceURI : String, specify the namespace URI to be queried
• localName : String, the label name to be retrieved. The value "*" matches all tags

Return result:

• XmlNodeList , an XmlNodeList collection of XmlElement nodes with specified tags in the node tree. The order of returned element nodes is the order in which they appear in the source document.

This method is similar to the getElementsByTagName method, except that the tag name of the element you want to get is specified as a combination of the namespace URI and the local name defined in the namespace.

getElementById

Returns the element with the specified id attribute

1
XmlElement XmlElement.getElementById(String id);

Call parameters:

• id : String, id to be retrieved

Return result:

• XmlElement , the XmlElement node with the specified id attribute in the node tree

This method will traverse the descendant nodes of the specified element and return an XmlElement node object representing the first document element with the specified id attribute. .

XmlDocument interface also defines the getElementsByTagName method, which is similar to this method, but traverses the entire document instead of traversing the descendants of an element.

getElementsByClassName

Return a node list of all elements with the specified class name

1
XmlNodeList XmlElement.getElementsByClassName(String className);

Call parameters:

• className : String, the name of the class to be retrieved

Return result:

• XmlNodeList , the XmlNodeList collection of XmlElement nodes with the specified class name in the document tree. The order of returned element nodes is the order in which they appear in the source document.

This method will return an XmlNodeList object (which can be processed as a read-only array), which stores all XmlElement nodes with the specified class name in the document. The order in which they are stored is the order in which they appear in the source document. XmlNodeList object is "live", that is, if an element with a specified tag name is added or deleted in the document, its content will automatically be updated as necessary.

hasChildNodes

Query whether there are child nodes

1
Boolean XmlElement.hasChildNodes();

Return result:

• Boolean , return true if there are any child nodes, otherwise return false

normalize

Merge adjacent Text nodes and delete empty Text nodes

1
XmlElement.normalize();

This method will traverse all descendant nodes of the current node, and normalize the document by deleting the empty Text node and merging all adjacent Text nodes. This method is useful for simplifying the structure of the document tree after inserting or deleting nodes.

cloneNode

Create an exact copy of the specified node

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

Call parameters:

• deep : Boolean, whether to deep copy, when true, the cloned node will clone all child nodes of the original node

Return result:

• XmlNode , return the copied node

This method will copy and return a copy of the node that called it. If the parameter passed to it is true, it will also recursively copy all descendants of the current node. Otherwise, it only copies the current node. The returned node does not belong to the document tree, and its parentNode property is null. When the Element node is copied, all its attributes will be copied.

lookupPrefix

Returns the prefix matching the specified namespace URI on the current node

1
String XmlElement.lookupPrefix(String namespaceURI);

Call parameters:

• namespaceURI : String, specify the matching namespace URI

Return result:

• String , returns the matched prefix, returns null if it is not matched

lookupNamespaceURI

Returns the namespace URI that matches the specified prefix on the current node

1
String XmlElement.lookupNamespaceURI(String prefix);

Call parameters:

• prefix : String, specify the matching prefix

Return result:

• String , returns the matching namespace URI, returns null if it is not matched

insertBefore

Insert a new child node before the existing child node

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

Call parameters:

• newChild : XmlNode , insert a new node
• refChild : XmlNode , insert a new node before this node

Return result:

• XmlNode , returns the new child node

If newChild already exists in the document tree, it will be deleted from the document tree and then reinserted in its new position. Nodes from one document (or nodes created by one document) cannot be inserted into another document. In other words, the ownerDocument property of newChild must be the same as the ownerDocument property of the current node.

insertAfter

Insert a new child node after the existing child node

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

Call parameters:

• newChild : XmlNode , insert a new node
• refChild : XmlNode , insert a new node after this node

Return result:

• XmlNode , returns the new child node

If newChild already exists in the document tree, it will be deleted from the document tree and then reinserted in its new position. Nodes from one document (or nodes created by one document) cannot be inserted into another document. In other words, the ownerDocument property of newChild must be the same as the ownerDocument property of the current node.

appendChild

Add a new child node to the end of the node's child node list

1
XmlNode XmlElement.appendChild(XmlNode newChild);

Call parameters:

• newChild : XmlNode , specify the added node

Return result:

• XmlNode , return this new child node

If newChild already exists in the document tree, it will be deleted from the document tree and then reinserted in its new position. Nodes from one document (or nodes created by one document) cannot be inserted into another document. In other words, the ownerDocument property of newChild must be the same as the ownerDocument property of the current node.

replaceChild

Replace one child node with another

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

Call parameters:

• newChild : XmlNode , specify a new node
• oldChild : XmlNode , specify the node to be replaced

Return result:

• XmlNode , if the replacement is successful, this method can return the replaced node, if the replacement fails, it returns null

If newChild already exists in the document tree, it will be deleted from the document tree and then reinserted in its new position. Nodes from one document (or nodes created by one document) cannot be inserted into another document. In other words, the ownerDocument property of newChild must be the same as the ownerDocument property of the current node.

removeChild

Remove a node from the list of child nodes

1
XmlNode XmlElement.removeChild(XmlNode oldChild);

Call parameters:

• oldChild : XmlNode , specify the node to be deleted

Return result:

• XmlNode , if the deletion is successful, this method can return the deleted node, if it fails, it returns null

toString

Returns the string representation of the object, generally returns "[Native Object]", the object can be re-implemented according to its own characteristics

1
String XmlElement.toString();

Return result:

• String , returns the string representation of the object

toJSON

Returns the JSON format representation of the object, generally returns a collection of readable attributes defined by the object

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

Call parameters:

• key : String, unused

Return result:

• Value , returns a value containing JSON serializable