يمثل الكائن الوثيقة وثيقة XML بأكملها.
كائن المستند XML
كائن المستند هو أصل وثيقة شجرة XML، ويعطي لنا الوصول الأساسي لبيانات الوثيقة.
منذ العقد عنصر، النص العقد، والتعليقات، إرشادات المعالجة، وما إلى ذلك لا يمكن أن توجد خارج المستند، يحتوي على كائن الوثيقة أيضا طرق لإنشاء هذه الكائنات. الكائنات عقدة تحتوي على خاصية ownerDocument التي يقرنها وثيقة حيث تم إنشاؤها.
خصائص كائن المستند
| الملكية | وصف |
|---|---|
| childNodes | إرجاع NodeList من العقد التابعة للوثيقة |
| doctype | ترجع إعلان نوع الوثيقة المرتبطة مع وثيقة |
| documentElement | إرجاع عقدة الجذر من الوثيقة |
| documentURI | مجموعات أو إرجاع موقع المستند |
| domConfig | إرجاع التكوين المستخدم عندما normalizeDocument() يتم استدعاء |
| firstChild | إرجاع العقدة الطفل الأولى من المستند |
| implementation | يعود الكائن DOMImplementation الذي يعالج هذه الوثيقة |
| inputEncoding | بإرجاع ترميز تستخدم للوثيقة (when parsing) |
| lastChild | ترجع مشاركة عقدة تابعة للوثيقة |
| nodeName | يعود اسم عقدة (depending on its type) |
| nodeType | إرجاع نوع عقدة عقدة |
| nodeValue | مجموعات أو إرجاع قيمة عقدة (depending on its type) |
| xmlEncoding | إرجاع ترميز XML من الوثيقة |
| xmlStandalone | مجموعات أو إرجاع ما إذا كانت الوثيقة هي بذاتها |
| xmlVersion | مجموعات أو إرجاع النسخة XML وثيقة |
طرق كائن المستند
| طريقة | وصف |
|---|---|
| adoptNode(sourcenode) | يعتمد عقدة من وثيقة أخرى لهذه الوثيقة، وإرجاع العقدة المعتمدة |
| createAttribute(name) | يخلق عقدة السمة مع اسم محدد، وإرجاع الكائن ATTR جديد |
| createAttributeNS(uri,name) | يخلق عقدة سمة تحمل هذا الاسم المحدد ومساحة، وإرجاع الكائن ATTR جديد |
| createCDATASection() | يخلق قسم عقدة CDATA |
| createComment() | يخلق عقدة تعليق |
| createDocumentFragment() | يخلق كائن DocumentFragment فارغة، ويعيدها |
| createElement() | يخلق عقدة عنصر |
| createElementNS() | يخلق عقدة عنصر مع مساحة اسم محدد |
| createEntityReference(name) | يخلق كائن EntityReference، ويعيدها |
| createProcessingInstruction(target,data) | بإنشاء كائن ProcessingInstruction، ويعيدها |
| createTextNode() | يخلق عقدة النص |
| getElementById(id) | إرجاع عنصر يحتوي على سمة معرف مع قيمة معينة. إذا لا يوجد مثل هذا العنصر، فإنه يعود لاغية |
| getElementsByTagName() | إرجاع NodeList جميع العناصر مع اسم محدد |
| getElementsByTagNameNS() | إرجاع NodeList جميع العناصر مع اسم محدد ومساحة |
| importNode(nodetoimport,deep) | وتستورد عقدة من وثيقة أخرى لهذه الوثيقة. هذا الأسلوب بإنشاء نسخة جديدة من عقدة المصدر. إذا تم تعيين المعلمة العميق لصحيحا، وتستورد جميع الأطفال من العقدة المحددة. إذا تم رفض، وتستورد فقط العقدة نفسها. هذا الأسلوب بإرجاع عقدة المستوردة |
| normalizeDocument() | |
| renameNode() | إعادة تسمية عقدة عنصر أو سمة |
خصائص كائن DocumentType
كل وثيقة لها السمة DOCTYPE أن قيمتها إما خالية أو كائن DocumentType.
يوفر كائن DocumentType واجهة لجهات محددة لوثيقة XML.
| الملكية | وصف |
|---|---|
| name | يعود اسم DTD |
| publicId | إرجاع معرف العام للDTD |
| systemId | إرجاع معرف نظام من DTD خارجي |
طرق كائن DocumentImplementation
الكائن DOMImplementation ينفذ عمليات مستقلة عن أي حالة معينة من طراز كائن المستند.
| طريقة | وصف |
|---|---|
| createDocument(nsURI, name, doctype) | يخلق كائن المستند DOM جديد من نوع المستند المحدد |
| createDocumentType(name, pubId, systemId) | يخلق عقدة DocumentType فارغة |
| getFeature(feature, version) | بإرجاع كائن الذي ينفذ واجهات برمجة التطبيقات ميزة محددة، ونسخة، وإذا كان هو أي |
| hasFeature(feature, version) | اختبار ما إذا كان تنفيذ DOM تنفذ ميزة معينة والإصدار |
خصائص كائن ProcessingInstruction
يمثل الكائن ProcessingInstruction إرشادات معالجة.
يتم استخدام إرشادات معالجة باعتبارها وسيلة للحفاظ على المعلومات المعالج محددة في نص وثيقة XML.
| الملكية | وصف |
|---|---|
| data | مجموعات أو إرجاع محتويات هذا إرشادات معالجة |
| target | يعود الهدف من هذه التعليمات المعالجة |