الفرق بين المراجعتين لصفحة: «JavaScript/Document/createNSResolver»
إضافة الصّفحة |
طلا ملخص تعديل |
||
| سطر 16: | سطر 16: | ||
==ملاحظات== | ==ملاحظات== | ||
يتبنّى التّابع أي عقدة DOM لحلّ مجالات الأسماء لكي يتمّ تقدير (evaluate) تعبير XPath بسهولة حسب سياق العقدة ومكان ظهورها في المستند. هذا المتبنِّي يعمل كالتّابع <code>lookupNamespaceURI</code> المعرّف في مواصفة DOM Level 3 على العقد في حلّ رابط URI مجال الأسماء <code>namespaceURI</code> من سابقةٍ (prefix) مُعطاةٍ باستعمال المعلومات المتوفّرة حاليًّا في سلالة العقدة في وقت استدعاء التّابع <code>lookupNamespaceURI</code>. ويقوم كذلك بحلّ سابقة <code>xml</code> الضّمنيّة. | يتبنّى التّابع أي عقدة DOM لحلّ مجالات الأسماء لكي يتمّ تقدير (evaluate) تعبير [[JavaScript/XPath|XPath]] بسهولة حسب سياق العقدة ومكان ظهورها في المستند. هذا المتبنِّي يعمل كالتّابع <code>lookupNamespaceURI</code> المعرّف في مواصفة DOM Level 3 على العقد في حلّ رابط URI مجال الأسماء <code>namespaceURI</code> من سابقةٍ (prefix) مُعطاةٍ باستعمال المعلومات المتوفّرة حاليًّا في سلالة العقدة في وقت استدعاء التّابع <code>lookupNamespaceURI</code>. ويقوم كذلك بحلّ سابقة <code>xml</code> الضّمنيّة. | ||
ملاحظة: يُعرّف XPath أسماء QNames دون سابقة لموافقَة العناصر في مجال الأسماء null فقط. ليست هناك من طريقة في XPath للحصول على مجال الأسماء الافتراضيّ المُطبَّق على مرجع عناصر عاديّ (مثلًا، <code>p[@id='_myid']</code> لـمجال الأسماء <code>xmlns='http://www.w3.org/1999/xhtml'</code>). لموافقَة العناصر الافتراضيّة التي يكون مجال أسمائها مُغايرا للقيمة | ملاحظة: يُعرّف XPath أسماء QNames دون سابقة لموافقَة العناصر في مجال الأسماء <code>null</code> فقط. ليست هناك من طريقة في XPath للحصول على مجال الأسماء الافتراضيّ المُطبَّق على مرجع عناصر عاديّ (مثلًا، <code>p[@id='_myid']</code> لـمجال الأسماء <code>xmlns='http://www.w3.org/1999/xhtml'</code>). لموافقَة العناصر الافتراضيّة التي يكون مجال أسمائها مُغايرا للقيمة <code>null</code>، فعليك إمّا أن تُحيل إلى عنصرٍ مُعيّن باستخدام نموذج مثل <code>*namespace-uri()=http://www.w3.org/1999/xhtml and name()=p[@id='_myid']</code> (وهي [https://developer.mozilla.org/en-US/docs/Web/JavaScript/Introduction_to_using_XPath_in_JavaScript#Using_XPath_functions_to_reference_elements_with_its_default_namespace طريقة] تعمل جيّدًا لتعابير XPath الديناميكيّة عندما لا تكون مجالات الأسماء معروفة) أو أن تستعمل اختبارات أسماءٍ ذات سابقات (prefixed name tests)، وإنشاء حالِّ مجالات أسماء رابطٍ السابقة مع مجال الأسماء. اقرأ [https://developer.mozilla.org/en-US/docs/Web/JavaScript/Introduction_to_using_XPath_in_JavaScript#Implementing_a_User_Defined_Namespace_Resolver كيفيّة إنشاء حالّ مجالات أسماء] إن أردت استعمال هذه الطريقة. | ||
طُرح التّابع <code>Document.createNSResolver()</code> في مواصفة DOM Level 3. | طُرح التّابع <code>Document.createNSResolver()</code> في مواصفة DOM Level 3. | ||
مراجعة 10:48، 29 مارس 2018
يُنشئ التّابع Document.createNSResolver() كائنًا من النّوع XPathNSResolver الذي يحلّ مجالات الأسماء مع احترام التعريفات في النّطاق (scope) لعقدة مُحدَّدة.
البنية العامة
nsResolver = document.createNSResolver(node);
المعاملات
node
العقدة المراد استعمالها كسياقٍ لحلّ مجال الأسماء.
القيمة المعادة
nsResolver
كائنٌ من النّوع XPathNSResolver.
ملاحظات
يتبنّى التّابع أي عقدة DOM لحلّ مجالات الأسماء لكي يتمّ تقدير (evaluate) تعبير XPath بسهولة حسب سياق العقدة ومكان ظهورها في المستند. هذا المتبنِّي يعمل كالتّابع lookupNamespaceURI المعرّف في مواصفة DOM Level 3 على العقد في حلّ رابط URI مجال الأسماء namespaceURI من سابقةٍ (prefix) مُعطاةٍ باستعمال المعلومات المتوفّرة حاليًّا في سلالة العقدة في وقت استدعاء التّابع lookupNamespaceURI. ويقوم كذلك بحلّ سابقة xml الضّمنيّة.
ملاحظة: يُعرّف XPath أسماء QNames دون سابقة لموافقَة العناصر في مجال الأسماء null فقط. ليست هناك من طريقة في XPath للحصول على مجال الأسماء الافتراضيّ المُطبَّق على مرجع عناصر عاديّ (مثلًا، p[@id='_myid'] لـمجال الأسماء xmlns='http://www.w3.org/1999/xhtml'). لموافقَة العناصر الافتراضيّة التي يكون مجال أسمائها مُغايرا للقيمة null، فعليك إمّا أن تُحيل إلى عنصرٍ مُعيّن باستخدام نموذج مثل *namespace-uri()=http://www.w3.org/1999/xhtml and name()=p[@id='_myid'] (وهي طريقة تعمل جيّدًا لتعابير XPath الديناميكيّة عندما لا تكون مجالات الأسماء معروفة) أو أن تستعمل اختبارات أسماءٍ ذات سابقات (prefixed name tests)، وإنشاء حالِّ مجالات أسماء رابطٍ السابقة مع مجال الأسماء. اقرأ كيفيّة إنشاء حالّ مجالات أسماء إن أردت استعمال هذه الطريقة.
طُرح التّابع Document.createNSResolver() في مواصفة DOM Level 3.