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 are usually used asXmlElement Node and XmlAttr The child nodes of the node appear.

XmlText node inherited XmlCharacterData Interface through the slave XmlCharacterData The data attribute inherited from the interface or from XmlNode The nadevalue attribute inherited by the interface can access the text content of the XmlText node.

Use from XmlCharacterDataThe inherited method or the splitText() method defined by the XmlText interface itself can operate the XmlText node. useXmlDocument CreateTextNode to create a new XmlText node.

The XmlText node has no children.

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

Inheritance

Member attributes

data

String, the text contained in the node

1
String XmlText.data;

length

Integer, the number of characters contained in the node

1readonly Integer XmlText.length;

nodeType

Integer, returns the node type of the node

1readonly 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: Property name
XmlText: #text
XmlCDATASection: #cdata-section
XmlProcessingInstruction: Return to 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: Return the specified content data
XmlComment: Comment text
XmlDocument: null
XmlDocumentType: null

ownerDocument

XmlDocument, Returns the root element of the node (XmlDocument Object)

1readonly XmlDocument XmlText.ownerDocument;

parentNode

XmlNode, Can return the parent node of a node

1readonly XmlNode XmlText.parentNode;

childNodes

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

1readonly XmlNodeList XmlText.childNodes;

firstChild

XmlNode, Return the first child node of the node

1readonly XmlNode XmlText.firstChild;

lastChild

XmlNode, Return the last child node of the node

1readonly XmlNode XmlText.lastChild;

previousSibling

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

1readonly XmlNode XmlText.previousSibling;

nextSibling

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

1readonly XmlNode XmlText.nextSibling;

Member function

splitText

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

1XmlText XmlText.splitText(Integer offset);

Call parameters:

offset: Integer, specifies where to split the text node. Start value starts at 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 including the text content) before the position specified by the 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 The interface inherits the XmlText interface, XmlCDATASection Nodes can also use this method, but the newly created node is XmlCDATASection Node instead of XmlText node.

substringData

Extract substring from node

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, Return the extracted string

appendData

Append the string to the node

1
XmlText.appendData(String arg);

Call parameters:

arg: String, the string to be appended to the node

insertData

Insert string into node

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

Call parameters:

offset: Integer, the character position where the string is to be inserted into the node
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 delete

replaceData

Replace the characters 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

Query whether there are child nodes

1
Boolean XmlText.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

1XmlText.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 XmlText.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 XmlText.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 XmlText.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 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 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 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 the new child node

appendChild

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

1XmlNode XmlText.appendChild(XmlNode newChild);

Call parameters:

newChild: XmlNode, Specify the added node

Return result:

XmlNode, Return this new child 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

removeChild

Remove a node from the list of child nodes

1XmlNode 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 re-implemented according to its own characteristics

1
String XmlText.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 XmlText.toJSON(String key = "");

Call parameters:

key: String, unused

Return result:

Value, Returns a value containing JSON serializable

Development Guide

Basic module

Built-in objects

Community module

Object XmlText

Inheritance

Member attributes

data

length

nodeType

nodeName

nodeValue

ownerDocument

parentNode

childNodes

firstChild

lastChild

previousSibling

nextSibling

Member function

splitText

substringData

appendData

insertData

deleteData

replaceData

hasChildNodes

normalize

cloneNode

lookupPrefix

lookupNamespaceURI

insertBefore

insertAfter

appendChild

replaceChild

removeChild

toString

toJSON