CKTIS / HTML
list — свързване на поле за въвеждане с предложения
Атрибутът `list` свързва `input` с елемент `datalist`, който съдържа предложени стойности. Той не ограничава въведената стойност до тези предложения.
Версия: WHATWG HTML Living Standard; index snapshot date recorded separately
Синтаксис
<input type="text" list="choices">
<datalist id="choices">
<option value="HTML"></option>
</datalist>list препраща към datalist чрез неговия id в същото дърво. Стойността му е идентификатор, а не CSS селектор: използвайте topics, а не #topics. Атрибутът се прилага само за подходящи типове input, като text; не се прилага за password.
Елементите option в datalist предоставят предложения. list не налага въведената стойност да е сред тях: останалите ограничения за проверка на валидността продължават да важат. Ако е необходим избор от затворен списък, използвайте select.
Браузърът определя показването и филтрирането на предложенията. Ако няма съвпадащ елемент, няма източник на предложения. От значение е първият елемент със зададения id; ако той не е datalist, връзка не се установява. Избягвайте дублиращи се ID.
В примера свойството DOM input.list връща свързания datalist. Стойността JavaScript, която не е в списъка, остава валидна, затова последният ред на резултата е true.
Примери
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>list example</title>
<label for="topic">Topic</label>
<input id="topic" type="text" list="topics">
<datalist id="topics">
<option value="HTML"></option>
<option value="CSS"></option>
</datalist>
<pre id="result"></pre>
<script>
const input = document.getElementById('topic');
input.value = 'JavaScript';
document.getElementById('result').textContent =
`${input.list.id}\n${input.value}\n${input.checkValidity()}`;
</script>
</html>Резултат
topics JavaScript true
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.