Element: ariaPlaceholder プロパティ

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.

ariaPlaceholder は Element インターフェイスのプロパティで、aria-placeholder 属性の値を反映します。この属性は、コントロールに値がない場合表示する、ユーザーのデータ入力を助けることを意図した短いヒントを定義します。

メモ: 可能であれば、HTML の <input> 要素の type="text" と <textarea> を使用してください。これらは意味づけがあり、ARIA 属性を必要としません。

値

文字列です。

例

この例では、IDが txtBoxInput の要素の aria-placeholder 属性には文字列が設定されています。ariaPlaceholderを使用して、文字列を別の値に更新します。

html
<div id="txtboxLabel">Enter your five-digit zipcode</div>
<div
  role="textbox"
  id="txtBoxInput"
  contenteditable="true"
  aria-placeholder="5-digit zipcode"
  aria-labelledby="txtboxLabel"></div>
js
let el = document.getElementById("txtBoxInput");
console.log(el.ariaPlaceholder); // "5-digit zipcode"
el.ariaPlaceholder = "12345";
console.log(el.ariaPlaceholder); // "12345"

仕様書

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

ブラウザーの互換性

BCD tables only load in the browser

関連情報