الفرق بين المراجعتين لصفحة: «JavaScript/Document/createCDATASection»

المراجعة الحالية بتاريخ 14:34، 7 أكتوبر 2022

يُنشئُ التّابع Document.createCDATASection()‎ عقدةَ قسم CDATA جديدةً ويُعيدها.

البنية العامة

CDATASectionNode = document.createCDATASection(data)

`CDATASectionNode`

يُمثّل عقدةً من النّوع CDATASection.

`data`

سلسلةٌ نصيّة تحتوي على البيانات المرغوب إضافتها إلى قسم CDATA.

مثال

var docu = new DOMParser().parseFromString('<xml></xml>',  "application/xml")

var cdata = docu.createCDATASection('هنا عقدة البيانات');

docu.getElementsByTagName('xml')[0].appendChild(cdata);

alert(new XMLSerializer().serializeToString(docu));
// ستَعرضُ
// <xml><![CDATA[هنا عقدة البيانات]]></xml>

ملاحظات

يعمل هذا مع مستندات XML فقط، ولا يعمل مع مستندات HTML (لأنّ مُستندات HTML لا تدعم أقسام CDATA)؛ مُحاولة استعمال التّابع مع مُستندات HTML سترمي الاستثناء NOT_SUPPORTED_ERR.
سترمي كذلك الاستثناء NS_ERROR_DOM_INVALID_CHARACTER_ERR في حالة مُرّرت سلسلة الإغلاق ‎"‎]]>‎"‎ كجزءٍ من البيانات، لذا لا يُمكن استعمال بيانات مُزوَّدة من طرف المُستخدم بأمان دون تهريبها (unescaped) ودون رمي هذا الاستثناء (يُمكن استخدام التّابع document.createTextNode‎()‎ مكان هذا التّابع).

مصادر ومواصفات

مواصفة createCDATASection

@@ سطر 6: / سطر 6: @@
 CDATASectionNode = document.createCDATASection(data)
 </syntaxhighlight>
-*<code>CDATASectionNode</code>
-: يُمثّل عقدةً من النّوع [[CDATASection]].
-*<code>data</code>
+===<code>CDATASectionNode</code>===
-: سلسلةٌ نصيّة تحتوي على البيانات المرغوب إضافتها إلى قسم CDATA.
+يُمثّل عقدةً من النّوع [[CDATASection]].
+===<code>data</code>===
+سلسلةٌ نصيّة تحتوي على البيانات المرغوب إضافتها إلى قسم CDATA.
 ==مثال==
@@ سطر 27: / سطر 28: @@
 </syntaxhighlight>
 ==ملاحظات==
-* يعمل هذا مع مستندات XML فقط، ولا يعمل مع مستندات HTML (لأنّ مُستندات HTML لا تدعم أقسام CDATA)؛ مُحاولة استعمال التّابع مع مُستندات HTML سترمي الاستثناء <code>NOT_SUPPORTED_ERR</code>.
+* يعمل هذا مع مستندات XML فقط، ولا يعمل مع مستندات [[HTML]] (لأنّ مُستندات HTML لا تدعم أقسام CDATA)؛ مُحاولة استعمال التّابع مع مُستندات HTML سترمي الاستثناء <code>NOT_SUPPORTED_ERR</code>.
 * سترمي كذلك الاستثناء <code>NS_ERROR_DOM_INVALID_CHARACTER_ERR</code> في حالة مُرّرت سلسلة الإغلاق  ‎"‎]]>‎"‎ كجزءٍ من البيانات، لذا لا يُمكن استعمال بيانات مُزوَّدة من طرف المُستخدم بأمان دون تهريبها (unescaped) ودون رمي هذا الاستثناء (يُمكن  استخدام التّابع <code>[[Document/createTextNode|document.createTextNode‎()‎]]</code> مكان هذا التّابع).