Element: ariaRoleDescription プロパティ

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.

ariaRoleDescription は Element インターフェイスのプロパティで、要素のロールに関する人間が読み取り可能な、作者がローカライズした説明を定義する aria-roledescription (en-US) 属性の値を反映します。

値

文字列です。

例

この例では、ID が myApplication である要素の aria-roledescription 属性が設定されています。ariaRoleDescription を用いて値を更新することができます。

html
<div
  id="myApplication"
  role="application"
  aria-roledescription="a description of this widget">
  …
</div>
js
let el = document.getElementById("myApplication");
console.log(el.ariaRoleDescription); // "a description of this widget"
el.ariaRoleDescription = "an updated description of this widget";
console.log(el.ariaRoleDescription); // "an updated description of this widget"

仕様書

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

ブラウザーの互換性

BCD tables only load in the browser