الفرق بين المراجعتين ل"JavaScript/Document/createProcessingInstruction"
< JavaScript | Document
اذهب إلى التنقل
اذهب إلى البحث
ط (إزالة سطر فارغ) |
|||
سطر 9: | سطر 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) ودون رمي هذا الاستثناء والتّعامل معه. | ||
سطر 40: | سطر 40: | ||
==مصادر ومواصفات== | ==مصادر ومواصفات== | ||
− | * مواصفة [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/>