Element: ariaPlaceholder 屬性

Baseline 2023
新推出

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

Element 介面的 ariaPlaceholder 屬性反映了 aria-placeholder 屬性的值,該屬性定義了一個簡短的提示,用於在控制元件沒有值時幫助使用者輸入資料。

注意: 儘可能使用具有 type="text" 的 HTML <input> 元素或 <textarea> 元素,因為它們具有內建的語義,不需要 ARIA 屬性。

字串。

示例

在此示例中,ID 為 txtBoxInput 的元素的 aria-placeholder 屬性已設定為一個字串。使用 ariaPlaceholder,我們將該字串更新為另一個值。

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

規範

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

瀏覽器相容性

另見