Class TextImpl

  • All Implemented Interfaces:
    Serializable, Cloneable, CharacterData, EventTarget, Node, NodeList, Text
    Direct Known Subclasses:
    CDATASectionImpl, DeferredTextImpl

    public class TextImpl
    extends CharacterDataImpl
    implements CharacterData, Text
    Text nodes hold the non-markup, non-Entity content of an Element or Attribute.

    When a document is first made available to the DOM, there is only one Text object for each block of adjacent plain-text. Users (ie, applications) may create multiple adjacent Texts during editing -- see Node.normalize() for discussion.

    Note that CDATASection is a subclass of Text. This is conceptually valid, since they're really just two different ways of quoting characters when they're written out as part of an XML stream.

    Since:
    PR-DOM-Level-1-19980818.
    Version:
    $Id$
    See Also:
    Serialized Form
    • Constructor Detail

      • TextImpl

        public TextImpl()
        Default constructor
    • Method Detail

      • setValues

        public void setValues​(CoreDocumentImpl ownerDoc,
                              String data)
        NON-DOM: resets node and sets specified values for the current node
        Parameters:
        ownerDoc -
        data -
      • getNodeType

        public short getNodeType()
        A short integer indicating what type of node this is. The named constants for this value are defined in the org.w3c.dom.Node interface.
        Specified by:
        getNodeType in interface Node
        Specified by:
        getNodeType in class NodeImpl
      • setIgnorableWhitespace

        public void setIgnorableWhitespace​(boolean ignore)
        NON-DOM: Set whether this Text is ignorable whitespace.
      • isElementContentWhitespace

        public boolean isElementContentWhitespace()
        DOM L3 Core CR - Experimental 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 Document.normalizeDocument().
        Specified by:
        isElementContentWhitespace in interface Text
        Since:
        DOM Level 3
      • getWholeText

        public String getWholeText()
        DOM Level 3 WD - Experimental. Returns all text of Text nodes logically-adjacent text nodes to this node, concatenated in document order.
        Specified by:
        getWholeText in interface Text
        Since:
        DOM Level 3
      • insertTextContent

        protected void insertTextContent​(StringBuffer buf)
                                  throws DOMException
        internal method taking a StringBuffer in parameter and inserts the text content at the start of the buffer
        Parameters:
        buf -
        Throws:
        DOMException
      • replaceWholeText

        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.
        Specified by:
        replaceWholeText in interface Text
        Parameters:
        content - The content of the replacing Text node.
        Returns:
        text - The Text node created with the specified content.
        Throws:
        DOMException
        Since:
        DOM Level 3
      • isIgnorableWhitespace

        public boolean isIgnorableWhitespace()
        NON-DOM: Returns whether this Text is ignorable whitespace.
      • splitText

        public Text splitText​(int offset)
                       throws DOMException
        Break a text node into two sibling nodes. (Note that if the current node has no parent, they won't wind up as "siblings" -- they'll both be orphans.)
        Specified by:
        splitText in interface Text
        Parameters:
        offset - The offset at which to split. If offset is at the end of the available data, the second node will be empty.
        Returns:
        A reference to the new node (containing data after the offset point). The original node will contain data up to that point.
        Throws:
        DOMException(INDEX_SIZE_ERR) - if offset is <0 or >length.
        DOMException(NO_MODIFICATION_ALLOWED_ERR) - if node is read-only.
        DOMException
      • replaceData

        public void replaceData​(String value)
        NON-DOM (used by DOMParser): Reset data for the node.
      • removeData

        public String removeData()
        NON-DOM (used by DOMParser: Sets data to empty string. Returns the value the data was set to.