ElementInternals: ariaAutoComplete 属性

Baseline 2023

新推出

自 ⁨2023 年 10 月⁩ 以来，此功能已在最新设备和浏览器版本中得到支持。此功能可能无法在旧设备或浏览器上运行。

ariaAutoComplete 属性是 ElementInternals 接口的一部分，它反映了 aria-autocomplete 属性的值。该属性指示在组合框、搜索框或文本框中输入文本是否会触发用户预期值的预测显示，并指定了预测值的显示方式。

注意：在 ElementInternals 上设置 ARIA 属性允许为自定义元素定义默认语义。这些默认语义可能会被作者定义的属性覆盖，但可以确保在作者删除或根本未添加这些属性时，默认语义仍然保留。有关更多信息，请参阅 Accessibility Object Model explainer。

值

一个字符串，其值可能为以下之一：

"inline": 当用户输入文本时，可能会在插入符号后动态插入文本，以建议一种完成输入的方式。
"list": 当用户输入文本时，可能会显示一个包含一组可以完成用户输入的值的元素。
"both": 当用户输入文本时，可能会显示一个包含一组可以完成用户输入的值的元素。如果显示了该元素，集合中的一个值将被自动选中，并且完成该自动选中值所需的文本将出现在输入框的插入符号后面。
"none": 当用户输入文本时，不会显示任何自动建议来预测用户打算如何完成输入。

示例

在此示例中，ariaAutoComplete 的值设置为 "inline"。

class CustomControl extends HTMLElement {
  constructor() {
    super();
    this.internals_ = this.attachInternals();
    this.internals_.ariaAutoComplete = "inline";
  }
  // …
}

规范

规范
无障碍富互联网应用程序 (WAI-ARIA) # dom-ariamixin-ariaautocomplete

浏览器兼容性

帮助改进 MDN

了解如何贡献

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

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