TheText interface inherits fromCharacterData and represents the textual content (termed character data in XML) of anElement orAttr. If there is no markup inside an element's content, the text is contained in a single object implementing theText interface that is the only child of the element. If there is markup, it is parsed into the information items (elements, comments, etc.) andText nodes that form the list of children of the element.
When a document is first made available via the DOM, there is only oneText node for each block of text. Users may create adjacentText nodes that represent the contents of a given element without any intervening markup, but should be aware that there is no way to represent the separations between these nodes in XML or HTML, so they will not (in general) persist between DOM editing sessions. Thenormalize() method onNode merges any such adjacentText objects into a single node for each block of text.
See also theDocument Object Model (DOM) Level 2 Core Specification.
| Fields inherited from interface org.w3c.dom.Node |
ATTRIBUTE_NODE,CDATA_SECTION_NODE,COMMENT_NODE,DOCUMENT_FRAGMENT_NODE,DOCUMENT_NODE,DOCUMENT_TYPE_NODE,ELEMENT_NODE,ENTITY_NODE,ENTITY_REFERENCE_NODE,NOTATION_NODE,PROCESSING_INSTRUCTION_NODE,TEXT_NODE |
splitText(int offset)Breaks this node into two nodes at the specified offset, keeping both in the tree as siblings. | |
| Methods inherited from interface org.w3c.dom.CharacterData |
appendData,deleteData,getData,getLength,insertData,replaceData,setData,substringData |
publicTextsplitText(int offset) throwsDOMException
offset, keeping both in the tree as siblings. After being split, this node will contain all the content up to theoffset point. A new node of the same type, which contains all the content at and after theoffset point, is returned. If the original node had a parent node, the new node is inserted as the next sibling of the original node. When theoffset is equal to the length of this node, the new node has no data.offset - The 16-bit unit offset at which to split, starting from0.DOMException - INDEX_SIZE_ERR: Raised if the specified offset is negative or greater than the number of 16-bit units indata.