Интерфейс 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).