شیء Document
HTML DOM Nodes
در مدل HTML DOM هر چیزی یک گره(Node) است:
- سند خودش به تنهایی یک گره است.
- تمام عناصر HTML گره هستند.
- تمام خصوصیت های اچ تی ام ال، گره هستند.
- متن های درون عناصر اچ تی ام ال، گره متنی هستند.
- کامنت ها نیز گره comment هستند.
کلیه ی توابع و خصوصیت های شیء Document در جاوا اسکریپت
هنگامی که یک سند HTML در یک مرورگر وب بارگذاری می شود، تبدیل به یک شیء سند(document object) می شود.
شیء سند(document node) در واقع گره ریشه ی سند HTML و تمام گره های دیگر است:
گره های عنصر، گره های متن، گره های صفت، و گره های کامنت.
شیء سند، خصوصیات و متد ها را برای دسترسی به تمام اشیاء گره، از داخل جاوااسکریپت، ارائه می دهد.
نکته: سند(document) یک قسمت از شیء window است و می تواند توسط دستور window.document مورد دسترسی قرار بگیرد.
پشتیبانی مرورگرها
| Object | |||||
|---|---|---|---|---|---|
| Document | بله | بله | بله | بله | بله |
از جاوااسکریپت در تمام مرورگرهای بزرگ، پشتیبانی می شود.
کلیه توابع و خصوصیت های شیء Document در JavaScript Properties and Methods
خصوصیت ها و متدهای پیش رو می توانند بر روی اسناد HTML استفاده شوند:
| Property / متد | توضیحات |
|---|---|
| document.addEventListener() |
این متد، یک شنونده ی رویداد را به document اضافه می کند. |
| document.adoptNode() |
گرفتن یک node از یک document دیگر. |
| document.anchors |
این خصوصیت، یک مجموعه از عناصر <a> را در صفحه برمی گرداند. این عناصر دارای خصوصیت name هستند. |
| document.applets |
این خصوصیت، یک مجموعه از تمام عناصر <applet> را که در صفحه قرار دارند، برمی گرداند. |
| document.baseURI |
این خصوصیت، URI پایه و مطلق یک صفحه را برمی گرداند. |
| document.body |
این خصوصیت، عنصر <body> از صفحه را ست کرده یا برمی گرداند. |
| document.close() |
این متد، جریان خروجی که قبلا توسط document.open باز شده است را می بندد. |
| document.cookie |
این خصوصیت، تمام نام و مقدار کوکی ها را در سند برمی گرداند. |
| document.createAttribute() |
این متد، یک گره attribute را ایجاد می کند. |
| document.createComment() |
این متد، یک گره comment را با یک متن مشخص، ایجاد می کند. |
| document.createDocumentFragment() |
این متد، یک گره خالی DocumentFragment را ایجاد می کند. |
| document.createElement() |
این متد، یک گره Element را ایجاد می کند. |
| document.createTextNode() |
این متد، یک گره Text را ایجاد می کند. |
| document.doctype |
این خصوصیت، تعریف نوع سند ، که با سند(document) همراه شده است را برمی گرداند. |
| document.documentElement |
این خصوصیت، عنصر Document را از سند برمی گرداند(همان عنصر <html>). |
| document.documentMode |
این خصوصیت، حالتی که توسط مرورگر برای ارائه دادن سند استفاده شده است را برمی گرداند. |
| document.documentURI |
این خصوصیت، مکان سند را ست کرده یا برمی گرداند. |
| document.domain |
این خصوصیت، نام دامنه ای از سرور،که سند را بارگذاری کرده است، برمی گرداند. |
| document.domConfig |
منسوخ شده. پیکربندی DOM سند را برمی گرداند. |
| document.embeds |
این خصوصیت، یک مجموعه از تمام عناصر <embed> از سند را برمی گرداند. |
| document.forms |
این خصوصیت، یک مجموعه از تمام عناصر <form> را در سند برمی گرداند. |
| document.getElementById() |
این متد، یک عنصر را با یک خصوصیت ID ، با یک مقدار مشخص، را برمی گرداند. |
| document.getElementsByClassName() |
این متد، یک لیست از تمام عنصر ها، با یک نام کلاس مشخص را برمی گرداند. |
| document.getElementsByName() |
این متد، یک لیست که در بر دارنده ی تمام عناصر با یک نام مشخص است را برمی گرداند. |
| document.getElementsByTagName() |
این متد، یک لیست از تمام عنصر ها که دارای یک نام تگ مشخص هستند را برمی گرداند. |
| document.head |
این خصوصیت، عنصر <head> از سند را برمی گرداند. |
| document.images |
این خصوصیت، یک مجموعه از تمام عناصر <img> در سند را برمی گرداند. |
| document.implementation |
این خصوصیت، شیء DOMImplementation که این سند را بکار می برد، برمی گرداند. |
| document.importNode() |
این متد، یک گره را از یک سند دیگر وارد می کند. |
| document.inputEncoding |
این خصوصیت، کاراکتر رمزگذاری شده برای سند را برمی گرداند. |
| document.lastModified |
این خصوصیت، تاریخ و زمان آخرین دفعه ای که سند تغییر کرده (اصلاح شده) است را برمی گرداند. |
| document.links |
یک مجموعه از تمام عناصر <a> و <area> در سند، که دارای یک خصوصیت href می باشند را برمی گرداند. |
| document.normalize() |
این متد، گره های خالی را حذف کرده و گره های مجاور هم را با یکدیگر الحاق می کند. |
| document.normalizeDocument() |
این متد، گره های متنی خالی را حذف کرده و گره های مجاور را به یکدیگر الحاق می کند. |
| document.open() |
این متد، یک جریان خروجی را برای به دست آوردن خروجی از document.write ، باز می کند. |
| document.querySelector() |
این متد، اولین عنصری که با یک سلکتور css مشخص در سند تطابق یابد را برمی گرداند. |
| document.querySelectorAll() |
این متد، یک NodeList ایستا را که شامل تمام عناصری است که با یک سلکتور css مشخص در سند تطابق دارند را برمی گرداند. |
| document.readyState |
این خصوصیت، وضعیت(لود شدن) سند را برمی گرداند. |
| document.referrer |
این خصوصیت url سندی که سند جاری را بارگذاری کرده است،برمی گرداند. |
| document.removeEventListener() |
یک شنونده ی رویداد را از سند حذف می کند(که توسط متد addEventListener ایجاد شده است). |
| document.renameNode() |
این متد یک گره مشخص شده را تغییر نام می دهد. |
| document.scripts |
یک مجموعه از عناصر <script> در سند را برمی گرداند. |
| document.strictErrorChecking |
این خصوصیت، مشخص می کند که آیا error-checking اجرا شده است یا نه. |
| document.title |
این خصوصیت، عنوان سند را ست کرده یا برمی گرداند. |
| document.URL |
این خصوصیت، url کامل سند HTML را برمی گرداند. |
| document.write() |
این متد، عبارت های HTML یا کدهای جاوااسکریپت را در سند چاپ می کند. |
| document.writeln() |
این متد، شبیه متد ()write می باشد اما یک کاراکتر newline را بعد از هر عبارت، اضافه می کند. |
اخطار!!!
در هسته ی W3C DOM شیء Document تمام خصوصیت ها و متدها را از شیء گره به ارث می برد.
بسیاری از این خصوصیت ها و متدهای به کار رفته در سندها، هیچ معنی ندارند.
از استفاده از این خصوصیت های شیء گره و متدها در اشیاء سند HTML اجتناب کنید.
| Property / متد | Reason for avoiding |
|---|---|
| document.attributes |
سند ها خصوصیت attribute را ندارند. |
| document.hasAttributes() |
سندها خصوصیت attribute را ندارند. |
| document.nextSibling |
سندها خصوصیت sibling ندارند. |
| document.nodeName |
این همواره document# است. |
| document.nodeType |
این همواره 9(DOCUMENT_NODE)است. |
| document.nodeValue |
سند ها node value ندارند. |
| document.ownerDocument |
سند ها owner document ندارند. |
| document.ownerElement |
سند ها owner element ندارند. |
| document.parentNode |
سند ها، parent Node ندارند. |
| document.previousSibling |
سند ها sibling ندارند. |
| document.textContent |
سند ها text content ندارند. |
- نوشته شده توسط احسان عباسی
- بازدید: 11385