Document.createCDATASection()
createCDATASection()
crée un nouveau noeud de section CDATA et le renvoie.
Syntaxe
CDATASectionNode = document.createCDATASection(data)
CDATASectionNode
est un noeud de Section CDATA.data
est une string (chaîne de caractères) contenant les données à ajouter à la section CDATA.
Exemple
var docu = new DOMParser().parseFromString('<xml></xml>', "application/xml")
var cdata = docu.createCDATASection('Some <CDATA> data & then some');
docu.getElementsByTagName('xml')[0].appendChild(cdata);
alert(new XMLSerializer().serializeToString(docu));
// Affiche : <xml><![CDATA[Some <CDATA> data & then some]]></xml>
Notes
- Cela fonctionnera uniquement avec XML, pas avec les documents HTML (car les documents HTML ne supportent pas les sections CDATA) ; le tenter sur un document HTML va lancer une exception
NOT_SUPPORTED_ERR
. - Va lancer une exception
NS_ERROR_DOM_INVALID_CHARACTER_ERR
si on essaye de soumettre la séquence CDATA de fermeture ("]]>") en tant que partie des données ; les données fournies par l'utilisateur non échappées, ne peuvent pas être utilisées en toute sécurité sans qu'avec cette méthode on obtienne cette exception (createTextNode()
peut souvent être utilisé à sa place).