|
655
|
1 |
=head1 NAME
|
|
|
2 |
|
|
|
3 |
XML::DOM::CDATASection - Escaping XML text blocks in XML::DOM
|
|
|
4 |
|
|
|
5 |
=head1 DESCRIPTION
|
|
|
6 |
|
|
|
7 |
XML::DOM::CDATASection extends L<XML::DOM::CharacterData> which extends
|
|
|
8 |
L<XML::DOM::Node>.
|
|
|
9 |
|
|
|
10 |
CDATA sections are used to escape blocks of text containing characters
|
|
|
11 |
that would otherwise be regarded as markup. The only delimiter that is
|
|
|
12 |
recognized in a CDATA section is the "]]>" string that ends the CDATA
|
|
|
13 |
section. CDATA sections can not be nested. The primary purpose is for
|
|
|
14 |
including material such as XML fragments, without needing to escape all
|
|
|
15 |
the delimiters.
|
|
|
16 |
|
|
|
17 |
The DOMString attribute of the Text node holds the text that is
|
|
|
18 |
contained by the CDATA section. Note that this may contain characters
|
|
|
19 |
that need to be escaped outside of CDATA sections and that, depending
|
|
|
20 |
on the character encoding ("charset") chosen for serialization, it may
|
|
|
21 |
be impossible to write out some characters as part of a CDATA section.
|
|
|
22 |
|
|
|
23 |
The CDATASection interface inherits the CharacterData interface through
|
|
|
24 |
the Text interface. Adjacent CDATASections nodes are not merged by use
|
|
|
25 |
of the Element.normalize() method.
|
|
|
26 |
|
|
|
27 |
B<NOTE:> XML::DOM::Parser and XML::DOM::ValParser convert all CDATASections
|
|
|
28 |
to regular text by default.
|
|
|
29 |
To preserve CDATASections, set the parser option KeepCDATA to 1.
|
|
|
30 |
|
|
|
31 |
|