org.w3c.dom

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

Все Суперинтерфейсы:

CharacterData, Узел

Все Известные Подынтерфейсы:

CDATASection, текст

public interface Text
extends CharacterData

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

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

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

См. также Объектную модель документа (ДОМ) Спецификация Ядра Уровня 3.

Полевая Сводка

Поля, наследованные от интерфейса org.w3c.dom. Узел

ATTRIBUTE_NODE, CDATA_SECTION_NODE, COMMENT_NODE, DOCUMENT_FRAGMENT_NODE, DOCUMENT_NODE, DOCUMENT_POSITION_CONTAINED_BY, DOCUMENT_POSITION_CONTAINS, DOCUMENT_POSITION_DISCONNECTED, DOCUMENT_POSITION_FOLLOWING, DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC, DOCUMENT_POSITION_PRECEDING, DOCUMENT_TYPE_NODE, ELEMENT_NODE, ENTITY_NODE, ENTITY_REFERENCE_NODE, NOTATION_NODE, PROCESSING_INSTRUCTION_NODE, TEXT_NODE

Сводка метода

Методы

Модификатор и Тип	Метод и Описание
Строка	getWholeText() Возвраты весь текст Text узлы логически смежные текстовые узлы к этому узлу, связанному в порядке документа.
boolean	isElementContentWhitespace() Возвраты, содержит ли этот текстовый узел пробел контента элемента, часто оскорбительно вызванный "игнорируемый пробел".
Текст	replaceWholeText(String content) Заменяет текст текущего узла и всех логически смежных текстовых узлов с указанным текстом.
Текст	splitText(int offset) Повреждения этот узел в два узла в указанном offset, хранение обоих в дереве как одноуровневые элементы.

Методы, наследованные от интерфейса org.w3c.dom. CharacterData

appendData, deleteData, getData, getLength, insertData, replaceData, setData, substringData

Методы, наследованные от интерфейса org.w3c.dom. Узел

appendChild, cloneNode, compareDocumentPosition, getAttributes, getBaseURI, getChildNodes, getFeature, getFirstChild, getLastChild, getLocalName, getNamespaceURI, getNextSibling, getNodeName, getNodeType, getNodeValue, getOwnerDocument, getParentNode, getPrefix, getPreviousSibling, getTextContent, getUserData, hasAttributes, hasChildNodes, insertBefore, isDefaultNamespace, isEqualNode, isSameNode, isSupported, lookupNamespaceURI, lookupPrefix, normalize, removeChild, replaceChild, setNodeValue, setPrefix, setTextContent, setUserData

Деталь метода

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().

С тех пор:

ДОМ Левель 3

getWholeText

String getWholeText()

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

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

Иллюстрация: значение barTextNode.wholeText является "barfoo"

С тех пор:

ДОМ Левель 3

replaceWholeText

Text replaceWholeText(String content)
                      throws DOMException

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

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

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

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

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

Иллюстрация: barTextNode.replaceWholeText ("эй") изменяет текстовый контент barTextNode с "эй"

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

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

Параметры:

content - Контент замены Text узел.

Возвраты:

Text узел создается с указанным контентом.

Броски:

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

С тех пор:

ДОМ Левель 3