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

CKTIS / HTML

HTML елемент: datalist

Елементът за списък с предложения дава на контрола необвързващи предложени стойности и позволява друга валидна стойност.

Версия: WHATWG HTML Living Standard; index snapshot date recorded separately

Синтаксис

<input list="cities"><datalist id="cities"><option value="Oslo"></datalist>

datalist се свързва със съвместим input чрез list, равно на неговия id; HTMLInputElement.list връща разрешения елемент или null.

Предложенията идват от наследници option: value е стойността за вмъкване, label може да я описва, а празни или disabled опции не са предложения.

datalist не е select и не изисква избор. Ограничения като required и pattern проверяват крайната стойност отделно, а интерфейсът и филтрирането се различават.

Примерът чрез options брои кандидатите, въвежда стойност извън списъка и извиква checkValidity(), за да потвърди, че value не е ограничена до предложенията.

Примери

<!doctype html>
<meta charset="utf-8">
<label>City <input id="city" name="city" list="cities" value="Oslo"></label>
<datalist id="cities">
  <option value="Oslo"></option>
  <option value="Tokyo"></option>
  <option value=""></option>
  <option value="Lima" disabled></option>
</datalist>
<output id="result"></output>
<script>
const city = document.querySelector("#city");
const source = document.querySelector("#cities");
const suggestions = [...source.options].filter(option => option.value && !option.disabled);
city.value = "Reykjavík";
document.querySelector("#result").textContent = `linked=${city.list === source}; options=${source.options.length}; suggestions=${suggestions.length}; unlisted=${city.value}; valid=${city.checkValidity()}`;
</script>

Резултат

linked=true; options=4; suggestions=2; unlisted=Reykjavík; valid=true

Резултатът потвърждава връзката, две използваеми предложения и валидна стойност извън списъка; не оценява вида на вграденото меню.

Източници