عنصر Element في XML DOM

عنصر Element

يُمثل عنصر Element العنصر في مستند XML. يمكن للعنصر أن يحتوي على خصائص وأعمدة أخرى أو نصوص. إذا كان العنصر يحتوي على نص، فإن هذا النص يُمثل في عقدة النص.

ملاحظة هامة:تخزن النصوص دائمًا في عقدة النص. إن الأخطاء الشائعة في معالجة DOM هي التصفح إلى عقدة العنصر واعتبار أن هذه العقدة تحتوي على نص. ومع ذلك، حتى العقدة الأبسط لعنصر تحتوي على عقدة نصية. على سبيل المثال، في <year>2005</year>، هناك عقدة عنصر (year)، ويوجد أيضًا عقدة نصية تحت هذه العقدة تحتوي على نص (2005).

بما أن عنصر Element هو أيضًا عقدة، يمكنه الاستفادة من خصائص وطرق عقدة Node.

خصائص عنصر Element.

خصائص وصف
attributes يستخدم لاستعادة خواص العنصر من NamedNodeMap.
baseURI ملك URI الأساسي للعنصر.
childNodes قائمة ملك أبناء العنصر.
firstChild أول عنصر فرعي للعنصر.
lastChild آخر عنصر فرعي للعنصر.
localName جزء المحلي من اسم العنصر.
namespaceURI ملك URI المساحة النمطية للعنصر.
nextSibling العنصر الذي يليه مباشرة.
nodeName العنوان النمطي للعنصر، اعتمادًا على النوع.
nodeType العنصر النمطي للعنصر.
ownerDocument العنصر الجذر (ملك المستند).
parentNode العنصر الأب.
prefix إعداد أو العودة بملك مفتاح المساحة النمطية للعنصر.
previousSibling العنصر الذي يقع قبله مباشرة.
schemaTypeInfo العنوان النمطي المرتبط بالعنصر.
tagName العنوان
textContent إعداد أو العودة بملك محتوى النص للعنصر وأبنائه.

طرق ملك Element

الطريقة وصف
appendChild() إضافة عناصر جديدة كأبناء إلى نهاية قائمة أبناء العنصر.
cloneNode() تكرار العنصر.
compareDocumentPosition() مقارنة موقف العناصر.
getAttribute() يعود بملك قيمة الخاصية.
getAttributeNS() يعود بملك قيمة الخاصية (بالمساحة النمطية).
getAttributeNode() يعود بملك Node الخاصية كملك Attribute.
getAttributeNodeNS() يعود بملك Node الخاصية (بالمساحة النمطية) كملك Attribute.
getElementsByTagName() يعود بملك NodeList لمقارنة العناصر التي تطابق العنصر المحدد وأبناء العناصر.
getElementsByTagNameNS() يعود بملك NodeList لمقارنة العناصر التي تطابق العنصر المحدد (بالمساحة النمطية) وأبناء العناصر.
getFeature(feature,version) يعود بملك DOM، الذي يحقق API المخصص للصفة والمسار.
getUserData(key) يعود بملك الشكل المرتبط بكائن المفتاح. يجب أولاً إعداد الكائن إلى هذا العنصر، باستخدام نفس المفتاح لتمييز setUserData.
hasAttribute() هل العنصر يحتوي على الخاصية التي تطابق الاسم المحدد.
hasAttributeNS() إرجاع ما إذا كان العنصر يمتلك خاصية تتطابق مع الاسم والمجال المحدد.
hasAttributes() إرجاع ما إذا كان العنصر يمتلك خاصيات.
hasChildNodes() إرجاع ما إذا كان العنصر يمتلك عقدات فرعية.
insertBefore() إدراج عقدة فرعية جديدة قبل العقدة الفرعية الحالية.
isDefaultNamespace(URI) إرجاع ما إذا كان namespaceURI المحدد هو المجال الافتراضي.
isEqualNode() تحقق مما إذا كانت العقدتين متطابقتين.
lookupNamespaceURI() إرجاع URI للمجال الذي يتطابق مع المقدمة المحددة.
lookupPrefix() إرجاع المقدمة التي تتطابق مع URI المحدد للاسم المحدد.
normalize()

يقوم طريقة normalize() بإزالة عقدات النص الفارغة وربط عقدات النص المجاورة.

تقديم جميع عقدات النص تحت العنصر (بما في ذلك الخاصيات)، حيث تقسم عقدات النص فقط بين بنية (مثل العناصر، التعليقات، تعليمات المعالجة، أجزاء CDATA ومراجع الكيان).

بمعنى، لا توجد عقدة نصية مجاورة ولا عقدة نصية فارغة.

removeAttribute() حذف الخاصية المحددة.
removeAttributeNS() حذف الخاصية المحددة (باسم المجال).
removeAttributeNode() حذف الخاصية المحددة.
removeChild() حذف العقدة الفرعية.
replaceChild() استبدال العقدة الفرعية.
setUserData(key,data,handler) إرتباط الكائن بالقيمة المحددة في العنصر.
setAttribute() إضافة خاصية جديدة.
setAttributeNS() إضافة خاصية جديدة (باسم المجال).
setAttributeNode() إضافة عقدة الخاصية الجديدة.
setAttributeNodeNS(attrnode) إضافة عقدة الخاصية الجديدة (باسم المجال).
setIdAttribute(name,isId) إذا كان خاصية isId من كائن Attribute صحيحة، فإن هذا الطريقة ستعرف الخاصية المحددة كخصوصية ID المحددة من قبل المستخدم.
setIdAttributeNS(uri,name,isId) إذا كانت خاصية isId من كائن Attribute صحيحة، فإن هذا الطريقة ستعرف الخاصية المحددة (باسم المجال) كخصوصية ID المحددة من قبل المستخدم.
setIdAttributeNode(idAttr,isId) إذا كان خاصية isId من كائن Attribute صحيحة، فإن هذا الطريقة ستعرف الخاصية المحددة كخصوصية ID المحددة من قبل المستخدم.