Object XmlText

XmlText object represents the text content of an element or attribute

The XmlText node represents a series of plain text in an XML document. Because plain text appears in elements and attributes of XML, XmlText nodes usually appear as children of XmlElement nodes and XmlAttr nodes.

The XmlText node inherits the XmlCharacterData interface. You can access the text content of the XmlText node through the data property inherited from the XmlCharacterData interface or the nadevalue property inherited from the XmlNode interface.

XmlText nodes can be manipulated using XmlCharacterData inherited from XmlCharacterData or the splitText() method defined by the XmlText interface itself. Use XmlDocument 's createTextNode to create a new XmlText node.

XmlText nodes have no child nodes.

For the method of deleting empty XmlText nodes and merged adjacent XmlText nodes from the subtree of the document, please refer to the XmlNode.normalize method.

Inheritance

Member attribute

data

String, the text contained in the node

1
String XmlText.data;

length

Integer, the number of characters in this node

1
readonly Integer XmlText.length;

nodeType

Integer, returns the node type of the node

1
readonly Integer XmlText.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 XmlText.nodeName;

The nodeName of different objects will return different values:

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

nodeValue

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

1
String XmlText.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 : returns 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 XmlText.ownerDocument;

parentNode

XmlNode , can return the parent node of a node

1
readonly XmlNode XmlText.parentNode;

childNodes

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

1
readonly XmlNodeList XmlText.childNodes;

firstChild

XmlNode , returns the first child node of the node

1
readonly XmlNode XmlText.firstChild;

lastChild

XmlNode , returns the last child node of the node

1
readonly XmlNode XmlText.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 XmlText.previousSibling;

nextSibling

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

1
readonly XmlNode XmlText.nextSibling;

Member function

splitText

Split the text node into two nodes according to the specified offset

1
XmlText XmlText.splitText(Integer offset);

Call parameters:

• offset : Integer, specifies where to split the text node. Start value starts with 0

Return result:

• XmlText , Text node split from the current node

This method will split the XmlText node into two nodes at the specified offset. The original XmlText node will be modified so that it contains the text content (but not the text content) before the position specified by offset. A new XmlText node will be created to store all characters from the offset position (including the character at that position) to the end of the original character. The new XmlText node is the return value of the method. In addition, if the original XmlText node has a parentNode, the new XmlText node will be inserted into this parent node, immediately after the original node.

XmlCDATASection interface inherits the XmlText interface. The XmlCDATASection node can also use this method, but the newly created node is the XmlCDATASection node, not the XmlText node.

substringData

Extract substrings from nodes

1
2
String XmlText.substringData(Integer offset,
    Integer count);

Call parameters:

• offset : Integer, the position of the first character to be returned
• count : Integer, the number of characters in the substring to be returned

Return result:

• String , returns the extracted string

appendData

Append string to node

1
XmlText.appendData(String arg);

Call parameters:

• arg : String, the string to append to the node

insertData

Insert string into node

1
2
XmlText.insertData(Integer offset,
    String arg);

Call parameters:

• offset : Integer, the character position of the node to be inserted into the string
• arg : String, the string to be inserted

deleteData

Delete text from node

1
2
XmlText.deleteData(Integer offset,
    Integer count);

Call parameters:

• offset : Integer, the position of the first character to be deleted
• count : Integer, the number of characters to be deleted

replaceData

Replace the character of the node with the specified string

1
2
3
XmlText.replaceData(Integer offset,
    Integer count,
    String arg);

Call parameters:

• offset : Integer, the character position of the node to be replaced
• count : Integer, the number of characters to be replaced
• arg : String, the string to be inserted

hasChildNodes

Check if there is a child node

1
Boolean XmlText.hasChildNodes();

Return result:

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

normalize

Merge adjacent Text nodes and delete empty Text nodes

1
XmlText.normalize();

This method will traverse all the descendants of the current node, by deleting the empty Text node, has merged all adjacent Text nodes to normalize the document. 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 XmlText.cloneNode(Boolean deep = true);

Call parameters:

• deep : Boolean, whether to deep copy, when true, the cloned node will clone all the 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 the 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 attribute is null. When copying an Element node, all its attributes will be copied.

lookupPrefix

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

1
String XmlText.lookupPrefix(String namespaceURI);

Call parameters:

• namespaceURI : String, specifies the matching namespace URI

Return result:

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

lookupNamespaceURI

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

1
String XmlText.lookupNamespaceURI(String prefix);

Call parameters:

• prefix : String, specify the matching prefix

Return result:

• String , returns the matching namespace URI, returns null if it does not match

insertBefore

Insert a new child node before the existing child node

1
2
XmlNode XmlText.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 , return 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 location. 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 XmlText.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 , return 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 location. 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 XmlText.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 location. 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 XmlText.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 location. 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 XmlText.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 reimplemented according to its own characteristics

1
String XmlText.toString();

Return result:

• String , returns a 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 XmlText.toJSON(String key = "");

Call parameters:

• key : String, unused

Return result:

• Value , returns a value containing JSON serializable