الفرق بين المراجعتين لصفحة: «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) جديدةً ويُعيدها. | ||
| سطر 10: | سطر 9: | ||
===المعاملات=== | ===المعاملات=== | ||
=== <code>Processing_instruction_node</code> === | ==== <code>Processing_instruction_node</code> ==== | ||
عقدةٌ من النّوع <code>[[JavaScript/ProcessingInstruction|ProcessingInstruction]]</code>. | عقدةٌ من النّوع <code>[[JavaScript/ProcessingInstruction|ProcessingInstruction]]</code>. | ||
=== <code>target</code> === | ==== <code>target</code> ==== | ||
يُشير إلى جزء الهدف في عقدة إرشاد المعالجة، <?target ... ?> مثلًا. | يُشير إلى جزء الهدف في عقدة إرشاد المعالجة، <code><?target ... ?></code> مثلًا. | ||
=== <code>data</code> === | ==== <code>data</code> ==== | ||
سلسلةٌ نصيّة تحتوي على البيانات المرغوب إضافتها إلى البيانات داخل العقدة. | سلسلةٌ نصيّة تحتوي على البيانات المرغوب إضافتها إلى البيانات داخل العقدة. | ||
===الاستثناءات=== | ===الاستثناءات=== | ||
=== <code>NOT_SUPPORTED_ERR</code> === | ==== <code>NOT_SUPPORTED_ERR</code> ==== | ||
يُرمى في حال لم يدعم المُتصفّح هذا التّابع (إصدارات أقدم من Firefox 9 مثلًا). | يُرمى في حال لم يدعم المُتصفّح هذا التّابع (إصدارات أقدم من Firefox 9 مثلًا). | ||
=== <code>DOM_INVALID_CHARACTER</code> === | ==== <code>DOM_INVALID_CHARACTER</code> ==== | ||
يُرمى عند مُحاولة إضافة هدف إرشاد مُعالجةٍ غير صالح (يجب أن يكون اسم XML أو الأحرف "xml" في أية حالة أحرف ممكنة) أو إذا كانت سلسلة الإنهاء ("?>") جزءًا من البيانات، لذا لا يُمكن استعمال بيانات مُزوَّدة من طرف المُستخدم بأمان دون تهريبها (unescaped) ودون رمي هذا الاستثناء والتّعامل معه. | يُرمى عند مُحاولة إضافة هدف إرشاد مُعالجةٍ غير صالح (يجب أن يكون اسم XML أو الأحرف "xml" في أية حالة أحرف ممكنة) أو إذا كانت سلسلة الإنهاء ("?>") جزءًا من البيانات، لذا لا يُمكن استعمال بيانات مُزوَّدة من طرف المُستخدم بأمان دون تهريبها (unescaped) ودون رمي هذا الاستثناء والتّعامل معه. | ||
| سطر 36: | سطر 35: | ||
alert(new XMLSerializer().serializeToString(docu)); | alert(new XMLSerializer().serializeToString(docu)); | ||
// | // يُظهرُ | ||
// <?xml-stylesheet href="mycss.css" type="text/css"?><xml/> | |||
</syntaxhighlight> | </syntaxhighlight> | ||
==مصادر ومواصفات== | ==مصادر ومواصفات== | ||
* مواصفة [http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#dom-document-createprocessinginstruction DOM 4: createProcessingInstruction] | * مواصفة [http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#dom-document-createprocessinginstruction DOM 4: createProcessingInstruction]. | ||
[[تصنيف:JavaScript]] | [[تصنيف:JavaScript]] | ||
المراجعة الحالية بتاريخ 15:50، 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/>