Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / HTML

list — conectar un campo de entrada con sugerencias

El atributo `list` conecta un `input` con un `datalist` que contiene valores sugeridos. No limita el valor introducido a esas sugerencias.

Versión: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxis

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

list hace referencia a un datalist mediante su id en el mismo árbol. Su valor es un identificador, no un selector CSS: usa topics, no #topics. El atributo solo se aplica a los tipos de input apropiados, como text; no se aplica a password.

Los elementos option de un datalist proporcionan sugerencias. list no obliga a que el valor introducido pertenezca a ellas: las demás restricciones de validación siguen aplicándose. Si se necesita elegir de una lista cerrada, usa select.

El navegador determina cómo se muestran y filtran las sugerencias. Si no hay un elemento coincidente, no existe una fuente de sugerencias. El primer elemento en el orden del árbol con el id indicado determina la asociación: si ese elemento no es un datalist, no se establece ninguna asociación. Evita los ID duplicados.

En el ejemplo, la propiedad DOM input.list devuelve el datalist asociado. El valor JavaScript, que no está en la lista, sigue siendo válido, por lo que la última línea del resultado es true.

Ejemplos

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

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes