متد document.getElementsByName

مثال (متد document.getElementsByName)

به دست آوردن تمام عناصر با یک نام مشخص:

var x = document.getElementsByName("fname");

در انتهای این صفحه، مثال های بیشتری آورده شده است.

تعریف و کاربرد

متد getElementsByName() یک مجموعه از تمام عناصر در سند را با یک نام مشخص(مقدار خصوصیت name) بعنوان یک شیء NodeList برمی گرداند.

شیء NodeList، یک مجموعه از گره ها را نشان می دهد. این گره ها می توانند به وسیله ی اندیس ها مورد دسترسی قرار بگیرند. اندیش شروع نیز 0 است.

نکته: شما می توانید با استفاده از خصوصیت length بر روی شیء NodeList، تعداد عناصر، با یک نام مشخص را به دست آورید و سپس می توانید بر روی تمام عناصر یک حلقه ایجاد کرده و اطلاعات خود را به دست بیاورید.

نکته: در HTML5، خصوصیت "name" بد دانسته شده است و با خصوصیت id برای بسیاری از عناصر، جایگزین شده است. هرجا که لازم است، می توانید از متد document.getElementById() استفاده کنید. همچنین نگاهی نیز به متدهای getElementsByClassName() و getElementsByTagName() بیاندازید.

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

متد
getElementsByName()	بله	بله	بله	بله	بله

نحوه استفاده

document.getElementsByName(name)

مقادیر پارامترها

پارامتر	Type	توضیحات
name	String	ضروری. مقدار خصوصیت نام عنصری که شما می خواهید به آن دسترسی پیدا کرده یا آن را دستکاری کنید.

جزئیات تکنیکی

DOM Version:	Core Level 1 کلیه توابع و خصوصیت های شیء Document در JavaScript
مقدار برگشتی	یک شیء NodeList که مشخص کننده ی یک مجموعه از عناصر با یک نام مشخص می باشد. عناصر درون مجموعه برگشت داده شده مانند موقعی که درون سورس کد ظاهر می شوند، ذخیره می شوند.

مثال - خودتان امتحان کنید

مثال (متد document.getElementsByName)

فهمیدن اینکه چه تعداد عنصر در سند با خصوصیت نام و مقدار "animal" وجود دارند(استفاده از خصوصیت length از شیء NodeList):

var x = document.getElementsByName("animal").length;

خودتان امتحان کنید »

مثال (متد document.getElementsByName)

به دست آوردن تمام عناصر (<"input type="checkbox>) در سند که دارای یک خصوصیت نام با مقدار "animal" هستند:

var x = document.getElementsByName("animal");
var i;
for (i = 0; i < x.length; i++) {
x[i].checked = true;
}

خودتان امتحان کنید »

کلیه توابع و خصوصیت های شیء Document در JavaScript

: نوشته شده توسط احسان عباسی; بازدید: 5507

برای درج دیدگاه، ابتدا باید وارد بیاموز شوید.

تمامی محصولات و خدمات این وبسایت، حسب مورد دارای مجوزهای لازم از مراجع مربوطه می‌باشند و فعالیت‌های این سایت تابع قوانین و مقررات جمهوری اسلامی ایران است.

مجوز نشر دیجیتال از وزرات فرهنگ و ارشاد اسلامی