Text interface inherits from CharacterData
and represents the textual content (termed character data in XML) of an Element or Attr. If there is no
markup inside an element's content, the text is contained in a single
object implementing the Text interface that is the only
child of the element. If there is markup, it is parsed into the
information items (elements, comments, etc.) and Text nodes
that form the list of children of the element.
When a document is first made available via the DOM, there is only one
Text node for each block of text. Users may create adjacent
Text 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. The
Node.normalize() method merges any such adjacent
Text objects into a single node for each block of text.
No lexical check is done on the content of a Text node
and, depending on its position in the document, some characters must be
escaped during serialization using character references; e.g. the
characters "<&" if the textual content is part of an element or of
an attribute, the character sequence "]]>" when part of an element,
the quotation mark character " or the apostrophe character ' when part of
an attribute.
See also the Document Object Model (DOM) Level 3 Core Specification.
| Modifier and Type | Method and Description |
|---|---|
| public String | getWholeText()
Returns all text of |
| public boolean | isElementContentWhitespace()
Returns whether this text node contains element content whitespace, often abusively called "ignorable whitespace". |
| public Text | Returns: TheText node created with the specified content.The content of the replacing content)Text node.Replaces the text of the current node and all logically-adjacent text nodes with the specified text. |
| public Text | Returns: The new node, of the same type as this node.The 16-bit unit offset at which to split, starting from
offset)0.Breaks this node into two nodes at the specified |
| getWholeText | back to summary |
|---|---|
| public String getWholeText() Returns all text of
+-----+
| <p> |
+-----+
/\
/ \
/-----\ +-------+
| bar | | &ent; |
\-----/ +-------+
|
|
/-----\
| foo |
\-----/
Figure: barTextNode.wholeText value is "barfoo"
| |
| isElementContentWhitespace | back to summary |
|---|---|
| public boolean isElementContentWhitespace() Returns whether this text node contains
element content whitespace, often abusively called "ignorable whitespace". The text node is
determined to contain whitespace in element content during the load
of the document or if validation occurs while using
| |
| replaceWholeText | back to summary |
|---|---|
| public Text replaceWholeText(String content) throws DOMException Replaces the text of the current node and all logically-adjacent text nodes with the specified text. All logically-adjacent text nodes are removed including the current node unless it was the recipient of the replacement text. This method returns the node which received the replacement text. The returned node is:
For instance, in the above example calling
+-----+
| <p> |
+-----+
|
|
/-----\
| yo |
\-----/
Figure: barTextNode.replaceWholeText("yo") modifies the
textual content of barTextNode with "yo"
Where the nodes to be removed are read-only descendants of an
For instance, in the example below calling
| |
| splitText | back to summary |
|---|---|
| public Text splitText(int offset) throws DOMException Breaks this node into two nodes at the specified
| |