مетод HTML DOM Document getElementById()

تعریف و استفاده

getElementById() این روش عنصری با id مشخص شده را بازگرداند.

اگر عنصر وجود نداشته باشد،getElementById() این روش null.

getElementById() این روش یکی از روش‌های بسیار استفاده شده در HTML DOM است. تقریباً هر بار که می‌خواهید یک عنصر HTML را بخوانید یا ویرایش کنید، از آن استفاده می‌کنید.

توجه:

هر id باید منحصر به فرد باشد، اما:

اگر دو یا چند عنصر با id مشابه وجود داشته باشد، getElementById() اولین یکی را بازگرداند.

لطفاً به: مراجعه کنید

مетод getElementsByTagName()

مетод getElementsByClassName()

مетод querySelector()

مетод querySelectorAll()

مثال

مثال 1

عنصر دارای id مشخص شده را دریافت کنید:

document.getElementById("demo");

آزمایش کنید

مثال 2

عنصر را دریافت کنید و رنگ آن را تغییر دهید:

const myElement = document.getElementById("demo");
myElement.style.color = "red";

آزمایش کنید

مثال 3

یا تنها رنگ آن را تغییر دهید:

document.getElementById("demo").style.color = "red";

آزمایش کنید

قوانین دستور زبان

document.getElementById(elementId)

پارامتر

پارامتر توضیح
elementId ضروری. ارزش id عنصر.

مقدار بازگشتی

نوع توضیح
موضوع

عنصر با id مشخص

اگر پیدا نشد، null برمی‌گرداند.

جزئیات فنی

getElementById() این روش یک روش مهم و کاربردی است، زیرا روشی ساده برای دستیابی به Element‌های نمایش‌دهنده عناصر مشخص مستند ارائه می‌دهد.

را جستجو می‌کند. elementId این روش به دنبال Element با ارزش id مشخص nullرا برمی‌گرداند. ارزش ویژگی id در مستند منحصر به فرد است، اگر این روش چندین Element با id مشخص پیدا کند، آن را برمی‌گرداند. اگر هیچ Element با id مشخص پیدا نشود، elementId نقطه Element، که یک Element تصادفی از این نوع را به طور تصادفی برمی‌گرداند، یا null.

توجه داشته باشید:نام این روش با Id پایان، نه IDاستفاده کنید، نه به اشتباه!

در مستندات HTML، این روش همیشه به دنبال ویژگی‌هایی با id مشخص است. لطفاً از HTMLDocument.getElementByName() روش، بر اساس ارزش ویژگی name آن برای جستجوی عناصر HTML استفاده می‌کند.

در مستندات XML، این روش از هر یک از ویژگی‌های نوع id برای جستجو استفاده می‌کند، بدون توجه به نام این ویژگی. اگر نوع ویژگی XML ناشناخته باشد (مانند XML parser که دقت نکرد یا نمی‌تواند DTD مستند را شناسایی کند)، این روش همیشه nullدر JavaScript کاربران وب، این روش به ندرت با مستندات XML استفاده می‌شود. در واقع،getElementById() این روش اولین بار به عنوان عضوی از رابط HTMLDocument تعریف شد، اما در DOM نسخه دوم به رابط Document اضافه شد.

پشتیبانی مرورگر

document.getElementById() ویژگی DOM Level 2 (2001) است.

همه مرورگرها از آن پشتیبانی می‌کنند:

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
پشتیبانی 9-11 پشتیبانی پشتیبانی پشتیبانی پشتیبانی

صفحات مرتبط

آموزش CSS:قواعد CSS

دستورالعمل CSS:مصنف #id CSS

دستورالعمل HTML DOM:ویژگی id属性 HTML DOM

دستورالعمل HTML DOM:اجزای Style HTML DOM