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。离线整理了版式、链接和媒体显示。
