مجموعه داده Element XML DOM
- صفحه قبل DOM Document
- صفحه بعدی DOM Attr
عنصر Element
عنصر Element نماینده‌ای از عناصر یک مستند XML است. عناصر می‌توانند شامل ویژگی‌ها، عناصر دیگر یا متون باشند. اگر عنصر شامل متنی باشد، این متن در گره متنی نشان داده می‌شود.
مatters to note:متون همیشه در گره‌های متنی ذخیره می‌شوند. یک خطای معمول در فرآیند پردازش DOM، حرکت به سمت گره‌های عنصر و فرض داشتن این که این گره‌ها شامل متون هستند، است. با این حال، حتی زیرترین گره‌های ساده‌ترین عناصر نیز شامل گره‌های متنی هستند. به عنوان مثال، در <year>2005</year>، یک گره عنصر (year) وجود دارد و این گره شامل یک گره متنی است که شامل متنی (2005) است.
به دلیل اینکه عنصر Element نیز یک گره است، می‌تواند ویژگی‌ها و روش‌های گره را ارث ببرد.
ویژگی‌های عنصر Element
| ویژگی‌ها | توضیحات |
|---|---|
| attributes | نماینده‌ای از ویژگی‌های یک عنصر. |
| 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() | نقطه‌ای که با نام مشخص است را به عنوان یک شیء Attribute برمی‌گرداند. |
| getAttributeNodeNS() | نقطه‌ای که با نام مشخص است (با نام فضایی) را به عنوان یک شیء Attribute برمی‌گرداند. |
| getElementsByTagName() | NodeListای که شامل نقطه‌های عناصر که با نام مشخص هستند و فرزندان آن‌ها می‌شود، را برمی‌گرداند. |
| getElementsByTagNameNS() | NodeListای که شامل نقطه‌های عناصر که با نام مشخص هستند (با نام فضایی) و فرزندان آن‌ها می‌شود، را برمی‌گرداند. |
| getFeature(feature,version) | DOM عنصری که API اختصاصی برای ویژگی و نسخه مشخص را پیاده‌سازی می‌کند، را برمی‌گرداند. |
| getUserData(key) | موردی را که با کلید مرتبط است، به عناصر موجود در این نقطه اضافه می‌کند. ابتدا باید این شیء را به این نقطه تنظیم کنید، از طریق استفاده از setUserData با کلید مشابه. |
| hasAttribute() | آیا عنصر دارای ویژگی‌ای با نام مشخص است؟ |
| hasAttributeNS() | hasAttributeNS() |
| برمی‌گرداند که عنصر آیا دارای ویژگی با نام و نام‌فضا مشخص شده است یا خیر. | برمی‌گرداند که عنصر آیا دارای ویژگی است یا خیر. |
| 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 به true باشد، این روش این ویژگی را به عنوان ویژگی ID تعیین شده توسط کاربر معرفی می‌کند. |
| setIdAttributeNS(uri,name,isId) | اگر ویژگی isId در شیء Attribute به true باشد، این روش این ویژگی (با نام‌فضا) را به عنوان ویژگی ID تعیین شده توسط کاربر معرفی می‌کند. |
| setIdAttributeNode(idAttr,isId) | اگر ویژگی isId در شیء Attribute به true باشد، این روش این ویژگی را به عنوان ویژگی ID تعیین شده توسط کاربر معرفی می‌کند. |
- صفحه قبل DOM Document
- صفحه بعدی DOM Attr
