الفرق بين المراجعتين لصفحة: «JavaScript/Document/createProcessingInstruction»
< JavaScript | Document
إضافة الصّفحة |
ط ←أمثلة |
||
| سطر 36: | سطر 36: | ||
alert(new XMLSerializer().serializeToString(docu)); | alert(new XMLSerializer().serializeToString(docu)); | ||
// | // يُظهرُ | ||
// <?xml-stylesheet href="mycss.css" type="text/css"?><xml/> | |||
</syntaxhighlight> | </syntaxhighlight> | ||
مراجعة 12:42، 25 مارس 2018
يُنشئ التّابع 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/>