大网数据广告活动
Web 标准与前端开发

Element:ariaAutoComplete 属性

· 52CE 我爱测

Element 接口的 **`ariaAutoComplete`** 属性反映了 `aria-autocomplete` 属性的值,该属性指示对于组合框(`combobox`)、搜索框(`searchbox`)或文本框(`textbox`),输入文本是否可能触发显示用户预期值的一个或多个预测,并指定如果进行预测,预测将如何呈现。

DOM

Element 接口的 ariaAutoComplete 属性反映了 aria-autocomplete 属性的值,该属性指示对于组合框(combobox)、搜索框(searchbox)或文本框(textbox),输入文本是否可能触发显示用户预期值的一个或多个预测,并指定如果进行预测,预测将如何呈现。

值

具有以下值之一的字符串:

  • "inline"
    • : 当用户输入时,建议文本可能被动态插入到光标之后,以提示一种完成当前输入的方式。
  • "list"
    • : 当用户输入时,可能会显示一个元素,其中包含一组可完成当前输入的候选值。
  • "both"
    • : 当用户输入时,可能会显示包含一组可能用于补全当前输入内容的值的元素;如果显示了该元素,则该组的一个值会被自动选中,且用于补全该自动选中值的文本会显示在输入框的光标之后。
  • "none"
    • : 当用户输入时,不会显示任何试图预测用户打算如何完成输入的自动建议。

示例

在此示例中,ID 为 animal 的元素上的 aria-autocomplete 属性被设置为 "inline"。通过 ariaAutoComplete,我们将它的值更新为 "list",这是调用 listbox 弹出框的组合框的预期值。

<div class="animals-combobox">
  <label for="animal">动物</label>
  <input
    id="animal"
    type="text"
    role="combobox"
    aria-autocomplete="inline"
    aria-controls="animals-listbox"
    aria-expanded="false"
    aria-haspopup="listbox" />
  <ul id="animals-listbox" role="listbox" aria-label="动物">
    <li id="animal-cat" role="option">猫</li>
    <li id="animal-dog" role="option">狗</li>
  </ul>
</div>
let el = document.getElementById("animal");
console.log(el.ariaAutoComplete); // inline
el.ariaAutoComplete = "list";
console.log(el.ariaAutoComplete); // list

规范

浏览器兼容性

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。