مجموعه عناصر فرم

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

elements مجموعه‌ای از تمام عناصر فرم بازمی‌گردانده می‌شود.

توضیحات:عناصر مجموعه بر اساس ترتیب ظهور آن‌ها در کد منبع مرتب می‌شوند.

توضیحات:elements 集合返回

元素内的所有元素,而不是文档中的所有 元素。如需获取文档中的所有 元素,请改用 مجموعه elements عناصر موجود در <form> را برمی‌گرداند، نه همه عناصر <form> موجود در مستند. برای دسترسی به همه عناصر <form> موجود در مستند، از استفاده کنید.مجموعه document.forms

.

مثال

مثال 1

یافتن تعداد عناصر مشخص شده در <form> تعیین شده:

آزمایش کنید

نتیجه x خواهد بود:

وارد کردن x = document.getElementById("myForm").elements.length;

3توجه:

مثال‌های بیشتری در پایین صفحه ارائه شده است.

نحوه استفادهformObject

.elements

.elements توضیح
ویژگی

length

توضیحات:تعداد عناصر موجود در <form> را برمی‌گرداند.

این ویژگی فقط خواندنی است.

این ویژگی فقط خواندنی است. توضیح
[index]

عنصر دارای شاخص مشخص شده در <form> (از 0 شروع می‌شود) را برمی‌گرداند.

توضیحات:اگر شماره شاخص از محدوده خارج شود، null برمی‌گرداند.

item(index)

عنصر دارای شاخص مشخص شده در <form> (از 0 شروع می‌شود) را برمی‌گرداند.

توضیحات:اگر شماره شاخص از محدوده خارج شود، null برمی‌گرداند.

namedItem(id)

عنصر دارای id مشخص شده در <form> را برمی‌گرداند.

توضیحات:اگر id وجود ندارد، null برمی‌گرداند.

جزئیات فنی

نسخه DOM: سند سطح 2 سطح هسته‌ای
مقدار بازگشتی:

عنصر HTMLFormsControlCollection، نماینده همه عناصر <form> است.

عناصر مجموعه بر اساس ترتیب ظهور آنها در کد منبع مرتب می‌شوند.

مثال‌های بیشتر

مثال 2: [index]

گرفتن ارزش اولین عنصر فرم (شاخص 0):

وارد کردن x = document.getElementById("myForm").elements[0].value;

آزمایش کنید

نتیجه x خواهد بود:

Donald

مثال 3: item(index)

گرفتن ارزش اولین عنصر فرم (شاخص 0):

وارد کردن x = document.getElementById("myForm").elements.item(0).value;

آزمایش کنید

نتیجه x خواهد بود:

Donald

مثال 4: namedItem(id)

گرفتن ارزش عنصر name="fname" فرم:

وارد کردن x = document.getElementById("myForm").elements.namedItem("fname").value;

آزمایش کنید

نتیجه x خواهد بود:

Donald

مثال 5

دوره‌پیمایی همه عناصر فرم و چاپ ارزش هر عنصر:

وارد کردن x = document.getElementById("myForm");
وارد کردن txt = "";
وارد کردن i;
برای (i = 0; i < x.length; i++) {
  txt = txt + x.elements[i].value + "<br>";
}
document.getElementById("demo").innerHTML = txt;

آزمایش کنید

نتیجه x خواهد بود:

Donald
Duck
Submit

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

Chrome Edge Firefox Safari Opera
Chrome Edge Firefox Safari Opera
پشتیبانی پشتیبانی پشتیبانی پشتیبانی پشتیبانی