Интерфейс 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 ядра DOM (Document Object Model).