Document.createProcessingInstruction()‎

من موسوعة حسوب
اذهب إلى: تصفح، ابحث

يُنشئ التّابع Document.createProcessingInstruction()‎ عقدةَ إرشادِ مُعالجة (processing instruction node) جديدةً ويُعيدها.

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

Processing_instruction_node = document.createProcessingInstruction(target, data)

المعاملات

Processing_instruction_node

عقدةٌ من النّوع ProcessingInstruction.

target

يُشير إلى جزء الهدف في عقدة إرشاد المعالجة، ‎<?‎target ... ?‎>‎ مثلًا.

data

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

الاستثناءات

NOT_SUPPORTED_ERR

يُرمى في حال لم يدعم المُتصفّح هذا التّابع (إصدارات أقدم من Firefox 9 مثلًا).

DOM_INVALID_CHARACTER

يُرمى عند مُحاولة إضافة هدف إرشاد مُعالجةٍ غير صالح (يجب أن يكون اسم XML أو الأحرف "xml" في أية حالة أحرف ممكنة) أو إذا كانت سلسلة الإنهاء (‎"?‎>"‎) جزءًا من البيانات، لذا لا يُمكن استعمال بيانات مُزوَّدة من طرف المُستخدم بأمان دون تهريبها (unescaped) ودون رمي هذا الاستثناء والتّعامل معه.

أمثلة

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

var pi = docu.createProcessingInstruction('xml-stylesheet', 'href="mycss.css" type="text/css"');

docu.insertBefore(pi, docu.firstChild);

alert(new XMLSerializer().serializeToString(docu));
// يُظهرُ
//  <?xml-stylesheet href="mycss.css" type="text/css"?><xml/>

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