document.createCDATASection

概要

createCDATASection() は、新規 CDATA セクションを生成し返します。

構文

CDATASectionNode = document.createCDATASection(data); 

• CDATASectionNode : CDATA セクションのノード
• data : CDATA セクションに追加するデータを含む文字列

例

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));
// 表示結果: <xml><![CDATA[Some <CDATA> data & then some]]></xml>

注記

引数として渡す文字列データの一部に クロージング CDATA シーケンス ("]]>") を含めた場合、 NS_ERROR_DOM_INVALID_CHARACTER_ERR 例外がスローされてしまいます。もしこの様な文字列が含まれる可能性がある場合、createTextNode() を用いることでこの問題を回避することが出来ます。

• HTML 文書は CDATE セクションをサポートしておらず、よってこのメソッドは XML のみで動作します。 HTML 文書でこれを用いた場合、 NOT_SUPPORTED_ERR がスローされます。

仕様書

• createCDATASection