Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

element HTML: datalist

Element listy sugestii dostarcza kontrolce formularza niewiążący zestaw proponowanych wartości, pozostawiając możliwość wpisania innej poprawnej wartości.

Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately

Składnia

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

datalist łączy się ze zgodnym input przez atrybut list równy jego id; właściwość HTMLInputElement.list zwraca rozwiązany element albo null.

Sugestie pochodzą z potomnych option: ich value jest wartością do wstawienia, label może dawać dodatkowy opis, a puste lub disabled opcje nie są propozycjami.

datalist nie jest select i nie wymusza wyboru. Ograniczenia takie jak required i pattern walidują końcową wartość niezależnie od listy, a wygląd i filtrowanie interfejsu zależą od przeglądarki.

Przykład przez options liczy kandydatów, wpisuje wartość spoza listy i używa checkValidity(), aby potwierdzić, że sama value nie jest ograniczona do sugestii.

Przykłady

<!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>

Wynik

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

Wynik potwierdza powiązanie, dwie użyteczne sugestie i poprawną wartość nieobecną na liście; nie ocenia natywnego wyglądu rozwijanej listy.

Źródła