База знанияИзпитен център
BGБългарски
Избери език13

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници