سند (DOM Document)
«سند (DOM Document)» ریشه کل فایل XML است. یعنی درخت از اینجا شروع می شود. پس هر «گره (Node)» زیر این سند زندگی می کند. مثل دفتر مدرسه که همه اطلاعات، داخل یک دفتر اصلی نگه داری می شود.
شیء Document چیست؟
Document درخت XML را مدیریت می کند. بنابراین، ایجاد عنصر، متن، نظر و CDATA از این شیء انجام می شود. همچنین، هر گره یک ownerDocument دارد. این ویژگی نشان می دهد گره، مربوط به کدام سند است.
نمونه یک سند XML کامل
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE note SYSTEM "note.dtd">
<note id="n1">
<to>Ava</to>
<from>Reza</from>
<heading>Reminder</heading>
<body>Call me today.</body>
<!-- processing and comments are part of the document -->
</note>
اینجا «DOCTYPE» نوع سند را مشخص می کند. عنصر ریشه note است. بقیه گره ها، فرزند همین ریشه هستند. بنابراین، همه زیر نظر «سند DOM» هستند.
خواص مهم Document
- documentElement: ریشه سند را می دهد.
- doctype: به اطلاعات DTD دسترسی می دهد.
- childNodes: لیست فرزندان سطح بالا را برمی گرداند.
- xmlVersion/xmlEncoding: نسخه و کدگذاری XML را نشان می دهد.
- documentURI: محل یا آدرس سند را تنظیم یا می دهد.
متدهای کاربردی Document
- createElement(name): ساخت عنصر جدید.
- createTextNode(text): ساخت گره متن.
- createComment(text): ساخت نظر.
- getElementById(id): یافتن عنصر با شناسه.
- getElementsByTagName(name): لیست عناصر با نام.
- importNode(node, deep): کپی از سند دیگر، با یا بدون فرزندان.
- adoptNode(node): انتقال مالکیت گره از سندی دیگر.
گام های عملی کار با ساختار سند
- ریشه سند را با documentElement بخوان.
- با createElement یک عنصر بساز.
- متن را با createTextNode اضافه کن.
- عنصر را به ریشه ضمیمه کن.
ارتباط های مفید
برای آشنایی با فهرست های ترتیبی، صفحه NodeList (DOM NodeList) را ببین. همچنین برای خود مفهوم گره، صفحه گره (DOM Node) را مطالعه کن. اگر می خواهی درباره «سند DOM» در همین صفحه بمانی، روی سند DOM کلیک کن.
جمع بندی سریع
- Document ریشه کل XML است.
- ساخت همه گره ها از Document شروع می شود.
- documentElement عنصر ریشه را نشان می دهد.
- getElementById سریع و مستقیم جستجو می کند.