Интерфейс Text

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, который нельзя удалить.