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