Element: ariaMultiSelectable 属性

Baseline 2023
新推出

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

Element 接口的 ariaMultiSelectable 属性反映了 aria-multiselectable 属性的值,该属性指示用户可以从当前可选择的后代元素中选择多个项目。

注意: 如果可能,请使用 HTML <select> 元素,因为它具有内置的语义,不需要 ARIA 属性。

一个字符串,其值可能为以下之一:

"true"

一次可以选择多个项目。

"false"

只能选择一个项目。

示例

在此示例中,ID 为 listbox1 的元素上的 aria-multiselectable 属性设置为 "true",表明此输入接受多个选定的项目。使用 ariaMultiSelectable,我们将值更新为 "false"。

html
<div
  role="listbox"
  tabindex="0"
  id="listbox1"
  aria-multiselectable="true"
  aria-labelledby="listbox1label"
  aria-activedescendant="listbox1-1">
  <div role="option" id="listbox1-1" class="selected" aria-selected="true">
    Green
  </div>
  <div role="option" id="listbox1-2">Orange</div>
  <div role="option" id="listbox1-3">Red</div>
</div>
js
let el = document.getElementById("listbox1");
console.log(el.ariaMultiSelectable); // "true"
el.ariaMultiSelectable = "false";
console.log(el.ariaMultiSelectable); // "false"

规范

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

浏览器兼容性

另见