CKTIS / HTML
elemento HTML: datalist
O elemento de lista de sugestões fornece a um controlo valores propostos não vinculativos, permitindo introduzir outro valor válido.
Versão: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxe
<input list="cities"><datalist id="cities"><option value="Oslo"></datalist>datalist liga-se a um input compatível através de list igual ao seu id; HTMLInputElement.list devolve o elemento resolvido ou null.
As sugestões vêm de descendentes option: value é o valor a inserir, label pode descrevê-lo e opções vazias ou disabled não são propostas.
datalist não é select e não obriga a escolher. Restrições como required e pattern validam o valor final separadamente, e interface e filtragem variam no navegador.
O exemplo conta candidatos através de options, introduz valor fora da lista e chama checkValidity() para confirmar que value não se limita às sugestões.
Exemplos
<!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>
Resultado
linked=true; options=4; suggestions=2; unlisted=Reykjavík; valid=true
O resultado confirma a ligação, duas sugestões úteis e um valor válido fora da lista; não avalia o aspeto da lista nativa.