Интерфейс текста

Text splitText(int offset) throws DOMException

Разбивает этот узел на два узла в указанной offset, сохраняя оба в дереве как родственные. После разделения этот узел будет содержать все содержимое до точки offset. Возвращается новый узел того же типа, который содержит все содержимое в точке и после точки offset. Если у исходного узла был родительский узел, новый узел вставляется в качестве следующего родственного узла исходного узла. Если offset равно длине этого узла, новый узел не содержит данных.

boolean isElementContentWhitespace()

Возвращает, содержит ли этот узел текста пробелы содержимого элемента, часто некорректно называемые "пробелами, игнорируемыми пробелами". Узел текста определяется как содержащий пробелы в содержимом элемента во время загрузки документа или если выполняется валидация при использовании Document.normalizeDocument().

String getWholeText()

Возвращает весь текст узлов Text логически смежных узлов текста с этим узлом, соединенных в порядке документа.
Например, в примере ниже wholeText на узле Text , содержащем "bar", возвращает "barfoo", в то время как на узле Text , содержащем "foo", он возвращает "barfoo".

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

Рисунок: значение barTextNode.wholeText равно "barfoo"

Text replaceWholeText(String content) throws DOMException

Заменяет текст текущего узла и всех логически смежных узлов текста указанным текстом. Все логически смежные узлы текста удаляются, включая текущий узел, за исключением случая, когда он является получателем заменяющего текста.

Этот метод возвращает узел, который получил заменяющий текст. Возвращаемый узел:

• null, когда заменяющий текст является пустой строкой;
• текущий узел, за исключением случаев, когда текущий узел является только для чтения;
• новый узел Text того же типа (Text или CDATASection ) , что и текущий узел, вставленный в позицию замены.

Например, в приведенном выше примере вызов replaceWholeText на узле Text , содержащем "bar", со строкой "yo" в качестве аргумента, приводит к следующему:

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

Рисунок: barTextNode.replaceWholeText("yo") изменяет текстовое содержимое barTextNode на "yo"

Если узлы, которые должны быть удалены, являются потомками только для чтения элемента EntityReference, то EntityReference должен быть удален вместо узлов только для чтения. Если какой-либо EntityReference для удаления имеет потомков, которые не являются узлами EntityReference, Text или CDATASection, метод replaceWholeText должен завершиться неудачей, прежде чем выполняться какие-либо изменения в документе, вызывая DOMException с кодом NO_MODIFICATION_ALLOWED_ERR.

Например, в приведенном ниже примере вызов replaceWholeText на узле Text , содержащем "bar", завершается неудачей, потому что узел EntityReference "ent" содержит узел Element , который нельзя удалить.