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

CKTIS / HTML

elemento HTML: datalist

El elemento de lista de sugerencias ofrece a un control valores propuestos no vinculantes y permite introducir otro valor válido.

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

Sintaxis

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

datalist se conecta con un input compatible mediante list igual a su id; HTMLInputElement.list devuelve el elemento resuelto o null.

Las sugerencias proceden de descendientes option: value es el valor insertado, label puede describirlo y las opciones vacías o disabled no se proponen.

datalist no es select ni obliga a elegir. Restricciones como required y pattern validan el valor final aparte, y la interfaz y filtrado dependen del navegador.

El ejemplo cuenta candidatos mediante options, introduce un valor no listado y llama checkValidity() para confirmar que value no está limitada a las sugerencias.

Ejemplos

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

El resultado confirma la conexión, dos sugerencias útiles y un valor no listado válido; no evalúa el aspecto del desplegable nativo.

Fuentes