Element: ariaExpanded プロパティ

Baseline 2023

Newly available

Since October 2023, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

ariaExpanded は Element インターフェイスのプロパティで、aria-expanded (en-US) 属性の値を反映し、この要素が所有または制御するグループ化要素が展開されているか折りたたまれているかを示します。

値

以下のいずれかの値を持つ文字列です。

"true": この要素が所有または制御しているグループ化要素が展開されています。
"false": この要素が所有または制御しているグループ化要素が折り畳まれています。
"undefined": この要素は展開されているグループ化要素を所有または制御していません。

例

この例では、ID が animal の要素の aria-expanded 属性は "false" に設定されています。ariaExpanded を使用して、値を "true" に更新します。

html

<div class="animals-combobox">
  <label for="animal">Animal</label>
  <input
    id="animal"
    type="text"
    role="combobox"
    aria-autocomplete="list"
    aria-expanded="false"
    aria-haspopup="true" />
  <button id="animals-button" tabindex="-1" aria-label="Open">▽</button>
  <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>

let el = document.getElementById("animal");
console.log(el.ariaExpanded); // false
el.ariaExpanded = "true";
console.log(el.ariaExpanded); // true

仕様書

Specification
Accessible Rich Internet Applications (WAI-ARIA) # dom-ariamixin-ariaexpanded

ブラウザーの互換性

BCD tables only load in the browser