方法详细信息

• splitText

  Text splitText​(int offset)
          throws DOMException

  将此节点分解为指定的offset处的两个节点，将两个节点保留在树中作为兄弟节点。 拆分后，此节点将包含直到offset点的所有内容。 将返回相同类型的新节点，其中包含offset点及其后的所有内容。 如果原始节点具有父节点，则插入新节点作为原始节点的下一个兄弟节点。 当offset等于此节点的长度时，新节点没有数据。

  参数

  offset - 从 0开始分割的16位单位偏移量。

  结果

  新节点，与此节点的类型相同。

  异常

  DOMException - INDEX_SIZE_ERR：如果指定的偏移量为负或大于data的16位单元数，则data 。
  NO_MODIFICATION_ALLOWED_ERR：如果此节点是只读的，则引发此异常。

• isElementContentWhitespace

  boolean isElementContentWhitespace()

  返回此文本节点是否包含element content whitespace ，通常被称为“可忽略的空格”。 确定文本节点在加载文档期间包含元素内容中的空格，或者在使用Document.normalizeDocument()时进行Document.normalizeDocument() 。

  从以下版本开始：

  1.5，DOM Level 3

• getWholeText

  String getWholeText()

  返回Text节点逻辑上相邻的文本节点到此节点的所有文本，按文档顺序连接。
  例如，在下面的例子中wholeText的上Text包含“栏中的”返回“barfoo”，而在节点Text包含节点“foo”的则返回“barfoo”。

    +-----+
                       | <p> |
                       +-----+
                         /\
                        /  \
                 /-----\    +-------+
                 | bar |    | &ent; |
                 \-----/    +-------+
                                |
                                |
                             /-----\
                             | foo |
                             \-----/ 

  图：barTextNode.wholeText值为“barfoo”

  从以下版本开始：

  1.5，DOM Level 3

• replaceWholeText

  Text replaceWholeText​(String content)
                 throws DOMException

  用指定的文本替换当前节点的文本和所有逻辑上相邻的文本节点。 删除所有逻辑上相邻的文本节点，包括当前节点，除非它是替换文本的接收者。

  此方法返回接收替换文本的节点。 返回的节点是：

  • null ，当替换文本为空字符串时;
  • 当前节点，除非当前节点是只读的;
  • 新的Text相同类型的节点（ Text或CDATASection ）作为当前节点插入替换位置。

  例如，在上面的示例中，在Text节点上调用replaceWholeText ，其中包含“bar”并在参数中包含“yo”，结果如下：

    +-----+
                       | <p> |
                       +-----+
                          |
                          |
                       /-----\
                       | yo  |
                       \-----/ 

  图：barTextNode.replaceWholeText（“yo”）用“yo”修改barTextNode的文本内容

  如果要删除的节点是EntityReference只读后代，则必须删除EntityReference而不是只读节点。 如果任何EntityReference要去除具有不后代EntityReference ， Text ，或CDATASection节点，所述replaceWholeText方法必须在执行该文件的任何修改，养之前失败DOMException与代码NO_MODIFICATION_ALLOWED_ERR 。

  例如，在下面的示例中，在包含“bar”的Text节点上调用replaceWholeText失败，因为EntityReference节点“ent”包含无法删除的Element节点。

  参数

  content - 替换 Text节点的内容。

  结果

  使用指定内容创建的 Text节点。

  异常

  DOMException - NO_MODIFICATION_ALLOWED_ERR：如果要替换的 Text节点之一是只读的，则引发此异常。

  从以下版本开始：

  1.5，DOM Level 3