Document.createProcessingInstruction()
< JavaScript | Document
اذهب إلى التنقل
اذهب إلى البحث
The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.
يُنشئ التّابع 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/>