Интерфейс Text

Интерфейс Text наследуется от CharacterData и представляет текстовое содержимое (называемое данными символов в XML) Element или Attr. Если в содержании элемента нет разметки, текст содержится в одном объекте, реализующем интерфейс Text, который является единственным дочерним элементом. Если есть разметка, она парсится в элементы информации (элементы, комментарии и т. д.) и узлы Text , которые образуют список дочерних элементов.

Когда документ впервые становится доступным через DOM, для каждого блока текста существует только один узел Text. Пользователи могут создавать смежные узлы Text, которые представляют содержимое данного элемента без каких-либо промежуточных разметки, но должны учитывать, что нет способа представить разделения между этими узлами в XML или HTML, поэтому они не будут (в общем случае) сохраняться между сеансами редактирования DOM. Метод Node.normalize() объединяет любые такие смежные объекты Text в один узел для каждого блока текста.

Над содержимым узла Text не выполняется лексическая проверка и, в зависимости от его позиции в документе, некоторые символы должны быть экранированы при сериализации с помощью символьных ссылок; например, символы "<&" если текстовое содержимое является частью элемента или атрибута, последовательность символов "]]>" при части элемента, символ кавычки " или символ апострофа ' при части атрибута.

См. также Спецификацию уровня 3 ядра Document Object Model (DOM).

Методы

splitText

Text splitText(int offset)
        throws DOMException

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

Параметры:

offset - Смещение 16-разрядного блока, в котором нужно разделить, начиная с 0.

Возвращает:

Новый узел того же типа, что и этот узел.

Исключения:

DOMException - INDEX_SIZE_ERR: Выбрасывается, если указанное смещение отрицательное или больше, чем количество 16-разрядных блоков в data.
NO_MODIFICATION_ALLOWED_ERR: Выбрасывается, если этот узел является только для чтения.

isElementContentWhitespace

boolean isElementContentWhitespace()

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

С:

DOM Level 3

getWholeText

String getWholeText()

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

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

С:

DOM Level 3

replaceWholeText

Text replaceWholeText(String content)
               throws DOMException

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

Параметры:

content - Содержимое узла Text замены.

Возвращает:

Узел Text , созданный с указанным содержимым.

Исключения:

DOMException - NO_MODIFICATION_ALLOWED_ERR: Выбрасывается, если один из узлов Text замены является только для чтения.

С:

DOM Level 3