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