Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / HTML

list — associar um campo de entrada a sugestões

O atributo `list` associa um `input` a um `datalist` que contém valores sugeridos. Não limita o valor introduzido a essas sugestões.

Versão: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxe

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

list faz referência a um datalist através do respetivo id na mesma árvore. O valor é um identificador, não um seletor CSS: utiliza topics, não #topics. O atributo aplica-se apenas a tipos de input adequados, como text; não se aplica a password.

Os elementos option de um datalist fornecem sugestões. list não obriga a que o valor introduzido pertença a essas sugestões: as outras restrições de validação continuam a aplicar-se. Se for necessário escolher de uma lista fechada, utiliza select.

O navegador determina a apresentação e a filtragem das sugestões. Se não existir um elemento correspondente, não há uma fonte de sugestões. O primeiro elemento com o id indicado é o relevante; se não for um datalist, não é estabelecida qualquer associação. Evita IDs duplicados.

No exemplo, a propriedade DOM input.list devolve o datalist associado. O valor JavaScript, que não consta das sugestões, continua a ser válido; por isso, a última linha do resultado é true.

Exemplos

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

Resultado

topics
JavaScript
true

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes