Интерфейс CDATASection

public interface CDATASection extends Text

Разделы CDATA используются для экранирования блоков текста, содержащих символы, которые в противном случае рассматривались бы как разметка. Единственным разделителем, распознаваемым в разделе CDATA, является строка "]]>", которая завершает раздел CDATA. Разделы CDATA не могут быть вложены. Их основная цель — включение материалов, таких как фрагменты XML, без необходимости экранирования всех разделителей.

Атрибут CharacterData.data содержит текст, который содержится в разделе CDATA. Обратите внимание, что он может содержать символы, которые необходимо экранировать вне разделов CDATA, и что в зависимости от выбранного кодирования символов ("charset") для сериализации, некоторые символы могут быть невозможно записать как часть раздела CDATA.

Интерфейс CDATASection унаследован от интерфейса CharacterData через интерфейс Text. Соседние CDATASection узлы не объединяются с помощью метода normalize интерфейса Node.

Над содержимым раздела CDATA не выполняется лексическая проверка, и поэтому в содержимом может быть последовательность символов "]]>", которая является недопустимой в разделе CDATA в соответствии со статьей 2.7 [XML 1.0]. Наличие этой последовательности символов должно генерировать ошибку при сериализации, или раздел cdata должен быть разделен перед сериализацией (см. также параметр "split-cdata-sections" в интерфейсе DOMConfiguration).

Примечание: Поскольку разметка не распознается внутри CDATASection, числовые ссылки на символы не могут использоваться в качестве механизма экранирования при сериализации. Поэтому при сериализации CDATASection необходимо принять меры при кодировании символов, некоторые из которых не могут быть представлены. В противном случае не будет сгенерирован корректный XML.

Примечание: Одним из потенциальных решений в процессе сериализации является завершение раздела CDATA перед символом, вывод символа с помощью ссылки на символ или ссылки на сущность, и открытие нового раздела CDATA для любых дополнительных символов в текстовом узле. Однако некоторые библиотеки преобразования кода на момент написания не возвращают ошибку или исключение, когда символ отсутствует в кодировке, что делает задачу обеспечения того, чтобы данные не были повреждены при сериализации, более сложной.

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