طريقة XML DOM getElementById()
تعريف والاستخدام
يبحث طريقة getElementById() عن عنصر يحمل ID محدد.
النصغة:
getElementById(elementid)
| المتغيرات | وصف |
|---|---|
| elementid | القيمة التي ترغب في الحصول عليها الخاصة بالعنصر الذي تريد. |
القيمة المعدة للإرجاع
العنصر النود الذي يمثل العنصر في الوثيقة الذي يحمل الخاصية id المحددة. إذا لم يجد أي عنصر من هذا النوع، فيقوم بالعودة إلى null.
شرح
سيتحقق هذا الطريقة من قيمة الخاصية id التي تساوي elementid العنصر النود، ويقوم بتقديمها. إذا لم يجد أي عنصر من هذا النوع، فيقوم بالعودة إلى null. قيمة الخاصية id في الوثيقة هي فريدة، إذا وجد هذا الطريقة أكثر من عنصر يحمل نفس elementid العنصر النود، والتي ستعود عشوائياً إلى عنصر نود من هذا النوع أو تعود إلى null.
هذه طريقة هامة ومستخدمة بشكل واسع، لأنها توفر وسيلة سهلة للحصول على عنصر Element الذي يمثل العنصر المحدد في الوثيقة.
ملاحظة:اسم هذه الطريقة ينتهي بـ Id وليس ID، لا تنسى التدقيق في الكتابة.
في مستند HTML، تقوم هذه الطريقة دائمًا بالبحث عن الخاصية التي تحتوي على id المحدد. يمكنك استخدام طريقة getElementByName() في HTMLDocument، للبحث عن عناصر HTML بناءً على قيمة الخاصية name الخاصة بها.
في مستند XML، يستخدم هذا الطريقة باستخدام أي خاصية نوعها id، بغض النظر عن اسم هذه الخاصية. إذا كان نوع خاصية XML غير معروف (مثل عندما يغفل معالج XML أو لا يمكن تحديد DTD للمستند)، فإن هذه الطريقة تعود دائمًا null. لا تستخدم هذه الطريقة غالبًا مع مستندات XML في JavaScript العميل. في الواقع، تم تعريف getElementById() في البداية كعضو في واجهة HTMLDocument، ولكن تم نقله إلى واجهة Document في المستوى الثاني من DOM.
