الفرق بين المراجعتين لصفحة: «JavaScript/Document/createProcessingInstruction»
< JavaScript | Document
ط ←أمثلة |
ط إزالة سطر فارغ |
||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:<code>Document.createProcessingInstruction()</code>}}</noinclude> | <noinclude>{{DISPLAYTITLE:<code>Document.createProcessingInstruction()</code>}}</noinclude> | ||
يُنشئ التّابع <code>Document.createProcessingInstruction()</code> عقدةَ إرشادِ مُعالجة (processing instruction node) جديدةً ويُعيدها. | يُنشئ التّابع <code>Document.createProcessingInstruction()</code> عقدةَ إرشادِ مُعالجة (processing instruction node) جديدةً ويُعيدها. | ||
مراجعة 15:48، 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/>