XML DOM getElementById() Method
تعریف و استفاده
مетод getElementById() برای پیدا کردن عنصری با ID مشخص استفاده می‌شود.
تعریف و استفاده:
getElementById(elementid)
| پارامترها | توضیحات |
|---|---|
| elementid | ارزش id عنصری که می‌خواهید به آن دسترسی پیدا کنید. |
مقدار بازگشتی
نود Element برای عنصری که دارای id مشخصی است. اگر چنین عنصری پیدا نشود، null بازمی‌گردانده می‌شود.
توضیحات
این روش به دنبال ارزش id مشخصی است elementid نود عنصر، و آن را بازمی‌گرداند. اگر چنین نودی پیدا نشود، null بازمی‌گردانده می‌شود. ارزش id در مستند منحصر به فرد است، اگر این روش بیش از یک عنصر با id مشخصی elementid نود عنصر، که به صورت تصادفی یک نود عنصر از این نوع را بازمی‌گرداند، یا null.
این یک روش مهم و رایج است، زیرا به شما امکان می‌دهد به راحتی Element به نشان‌دهنده یک عنصر مشخصی از مستند دسترسی پیدا کنید.
توجه داشته باشید:نام این روش با Id پایان می‌یابد، نه ID، از اشتباه نکشید.
در مستندات HTML، این روش همیشه ویژگی‌های مشخص شده با id را جستجو می‌کند. می‌توانید از مетод HTMLDocument.getElementByName()بر اساس ارزش ویژگی name آنها به دنبال عناصر HTML می‌گردد.
در مستندات XML، این روش از هر یک از ویژگی‌های نوع id برای جستجو استفاده می‌کند، مهم نیست نام این ویژگی چیست. اگر نوع ویژگی XML ناشناخته باشد (مثلاً XML پارسر آن را نادیده گرفته یا نمی‌تواند DTD مستند را شناسایی کند)، این روش همیشه null را برمی‌گرداند. در JavaScript کاربران محلی، این روش به طور معمول با مستندات XML استفاده نمی‌شود. در واقع، getElementById() در ابتدا به عنوان عضو HTMLDocument تعریف شده بود، اما در نسخه دوم DOM به Document اضافه شد.
