XML DOM روش namedItem()

دستورالعمل موضوع HTMLCollection

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

روش namedItem() از مجموعه‌ای گره یا عنصر با نام مشخص شده را برمی‌گرداند.

به دلیل نوع مختلف مستندات، رفتار این روش نیز متفاوت است:

  • اگر مستند HTML است، این روش ابتدا به دنبال گره‌هایی با id属性 مطابقت‌دار با نام داده شده می‌گردد، اگر هیچ گره‌ای با این id وجود ندارد، به دنبال گره‌هایی با name属性 مطابقت‌دار با نام داده شده می‌گردد.

    این روش در جستجوی مستند HTML، حساس به حروف بزرگ و کوچک نیست.

  • اگر مستند XHTML باشد، این روش فقط گره‌هایی با id مطابقت داده شده را جستجو می‌کند.

    این روش در جستجوی مستند HTML، حساس به حروف بزرگ و کوچک است.

قانون‌گذاری:

htmlcollectionObject.namedItem(نام)
پارامتر توضیح
نام نام گره یا عنصر مورد نظر.

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

عنصر یا گره‌ای با id یا نام مشخص شده را برمی‌گرداند. اگر در HTMLCollection چنین گره‌ای نباشد، null برمی‌گرداند.

توضیح

در JavaScript، HTMLCollection به عنوان آرایه مرتبط در نظر گرفته می‌شود و با استفاده از نویسه‌های [] نام را جستجو می‌کنیم تا به راحتی‌تر باشد.

مثال

var c = document.forms;		//این یک موضوع HTMLCollection است
var address = c.namedItem("address");	//جستجوی <form name="address">
var payment = c["payment"];		//ساده‌تر از این: جستجوی <form name="payment">
var login = c.login;		//این نیز معتبر است: جستجوی <form name="login">

دستورالعمل موضوع HTMLCollection