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