مجموعه‌ی گزینه‌های Datalist

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

گزینه‌ها مجموعه بازمی‌گرداند عنصر <datalist> . همه‌ی گزینه‌ها را جمع‌آوری می‌کند.

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

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

دستورالعمل HTML:برچسب <datalist> HTML

دستورالعمل HTML:برچسب <option> HTML

مثال

مثال 1

تعداد گزینه‌های موجود در <datalist> مشخص شده را پیدا کنید:

var x = document.getElementById("browsers").options.length;

آزمایش کنید

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

5

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

جمله‌ی دستور زبان:

datalistObject.options

ویژگی

ویژگی توضیح
length

تعداد عناصر مجموعه <option> را برمی‌گرداند.

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

روش

روش توضیح
[index]

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

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

item(index)

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

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

namedItem(id)

با مشخص‌کننده id عناصر مجموعه‌ای که شامل عناصر <option> می‌شود.

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

جزئیات فنی

نسخه DOM: Core Level 2 Document Object
ارزش بازگشتی:

مجموعه HTMLCollection، که تمامی عناصر <datalist> را نمایندگی می‌کند عنصر <option>.

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

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

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

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

مثال 2: [index]

ارزش اولین گزینه در لیست داده‌ها (نشانگر 0) را دریافت کنید:

var x = document.getElementById("browsers").options[0].value;

آزمایش کنید

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

Internet Explorer

مثال 3: item(index)

ارزش اولین گزینه در لیست داده‌ها (نشانگر 0) را دریافت کنید:

var x = document.getElementById("browsers").options.item(0).value;

آزمایش کنید

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

Internet Explorer

مثال 4: namedItem(name_or_id)

ارزش گزینه‌ای با id="google" در لیست داده‌ها را دریافت کنید:

var x = document.getElementById("browsers").options.namedItem("google").value;

آزمایش کنید

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

Chrome

مثال 5

دوره‌پیمایی از تمامی گزینه‌های لیست داده‌ها و چاپ ارزش گزینه‌ها:

var x = document.getElementById("mySelect");
var txt = "";
var i;
برای (i = 0; i < x.options.length; i++) {
  txt = txt + x.options[i].value + "<br>";
}

آزمایش کنید

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

Internet Explorer
Firefox
Chrome
Opera
Safari