Element: ariaAutoComplete 屬性

Baseline 2023
新推出

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

Element 介面的 ariaAutoComplete 屬性反映了 aria-autocomplete 屬性的值。該屬性指示輸入文字是否會觸發顯示使用者對 combobox、searchbox 或 textbox 的預期值的預測,並指定了這些預測如果出現的話將如何呈現。

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

"inline"

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

"list"

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

"both"

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

"none"

當用戶輸入文字時,不會自動顯示任何試圖預測使用者意圖完成輸入的建議。

示例

在此示例中,ID 為 animal 的元素的 aria-autocomplete 屬性被設定為 "inline"。使用 ariaAutoComplete,我們將值更新為 "list",這是觸發 listbox 彈出視窗的 combobox 的預期值。

html
<div class="animals-combobox">
  <label for="animal">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="Animals">
    <li id="animal-cat" role="option">Cat</li>
    <li id="animal-dog" role="option">Dog</li>
  </ul>
</div>
js
let el = document.getElementById("animal");
console.log(el.ariaAutoComplete); // inline
el.ariaAutoComplete = "list";
console.log(el.ariaAutoComplete); // list

規範

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

瀏覽器相容性