元素：ariaPlaceholder 属性

基线 2023

新可用

自 2023 年 10 月起，此功能可在最新的设备和浏览器版本中使用。此功能可能在较旧的设备或浏览器中无法使用。

Element 接口的 ariaPlaceholder 属性反映了 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"

规范

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

浏览器兼容性

BCD 表格仅在浏览器中加载

另请参阅