ElementInternals: ariaAutoComplete 屬性

Baseline 2023
新推出

自 ⁨2023 年 10 月⁩ 以來,此功能已在最新裝置和瀏覽器版本中得到支援。此功能可能無法在舊裝置或瀏覽器上執行。

ariaAutoComplete 屬性是 ElementInternals 介面的一部分,它反映了 aria-autocomplete 屬性的值。該屬性指示在組合框、搜尋框或文字框中輸入文字是否會觸發使用者預期值的預測顯示,並指定了預測值的顯示方式。

注意:ElementInternals 上設定 ARIA 屬性允許為自定義元素定義預設語義。這些預設語義可能會被作者定義的屬性覆蓋,但可以確保在作者刪除或根本未新增這些屬性時,預設語義仍然保留。有關更多資訊,請參閱 Accessibility Object Model explainer

一個字串,其值可能為以下之一:

"inline"

當用戶輸入文字時,可能會在插入符號後動態插入文字,以建議一種完成輸入的方式。

"list"

當用戶輸入文字時,可能會顯示一個包含一組可以完成使用者輸入的值的元素。

"both"

當用戶輸入文字時,可能會顯示一個包含一組可以完成使用者輸入的值的元素。如果顯示了該元素,集合中的一個值將被自動選中,並且完成該自動選中值所需的文字將出現在輸入框的插入符號後面。

"none"

當用戶輸入文字時,不會顯示任何自動建議來預測使用者打算如何完成輸入。

示例

在此示例中,ariaAutoComplete 的值設定為 "inline"。

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

規範

規範
無障礙富網際網路應用程式 (WAI-ARIA)
# dom-ariamixin-ariaautocomplete

瀏覽器相容性