HTMLInputElement: list 属性

Baseline 已广泛支持

此功能已成熟，并可在多种设备和浏览器版本上运行。自 2019 年 3 月以来，它已在所有浏览器中可用。

HTMLInputElement 接口中只读的 list 属性会返回由该元素的 list 属性指向的 HTMLDataListElement，如果 list 属性未定义，或者 list 属性的值未与同一树中的任何 <datalist> 关联，则返回 null。

注意：这是一个只读属性。要将 <datalist> 与元素关联，请使用 setAttribute() 设置 list 属性的值。

值

一个 HTMLDataListElement 或 null。

示例

给定以下 HTML

html

<label for="planet">Which planet are you from?</label>
<input id="planet" type="text" list="superhero" />
<datalist id="superhero">
  <option value="Azarath"></option>
  <option value="Krypton"></option>
  <option value="Tamaran"></option>
</datalist>

您可以检索与 <input> 关联的 <datalist> 元素

const inputElement = document.querySelector("#planet");
console.log(inputElement.list); // returns the superhero HTMLDatalistElement

规范

规范
HTML # dom-input-list-dev

浏览器兼容性

另见

帮助改进 MDN

了解如何贡献

此页面最后修改于 ⁨2025年4月14日⁩，由 MDN 贡献者修改。

在 GitHub 上查看此页面 • 报告此内容的错误