Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

list — powiązanie pola z podpowiedziami

Atrybut `list` łączy pole `input` z elementem `datalist` zawierającym podpowiedzi. Nie ogranicza wpisywanej wartości do tych propozycji.

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

Składnia

<input type="text" list="choices">
<datalist id="choices">
  <option value="HTML"></option>
</datalist>

list wskazuje datalist przez jego id w tym samym drzewie. Wartość to identyfikator, nie selektor CSS: użyj topics, nie #topics. Atrybut działa tylko dla odpowiednich typów input, na przykład text; nie dotyczy typu password.

Elementy option w datalist dostarczają propozycje. list nie wymusza wyboru spośród nich: inne ograniczenia walidacji nadal obowiązują. Jeśli wymagany jest wybór z zamkniętej listy, użyj select.

Przeglądarka decyduje o wyglądzie i filtrowaniu podpowiedzi. Brak pasującego elementu oznacza brak źródła podpowiedzi. Liczy się pierwszy element o podanym id; jeśli nie jest to datalist, powiązanie nie powstaje. Unikaj powtarzania id.

W przykładzie właściwość DOM input.list zwraca powiązany datalist. Wartość JavaScript spoza propozycji pozostaje poprawna, więc ostatni wiersz wyniku to true.

Przykłady

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

Wynik

topics
JavaScript
true

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła