Element: ariaPlaceholder property
Baseline 2023Newly available
Since October 2023, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.
TheariaPlaceholder property of theElement interface reflects the value of thearia-placeholder attribute, which defines a short hint intended to aid the user with data entry when the control has no value.
Note:Where possible use an HTML<input> element withtype="text" or a<textarea> as these have built in semantics and do not require ARIA attributes.
Value
A string.
Examples
In this example thearia-placeholder attribute on the element with an ID oftxtBoxInput has been set to a string. UsingariaPlaceholder we update the string to another value.
html
<div>Enter your five-digit zip code</div><div role="textbox" 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"Specifications
| Specification |
|---|
| Accessible Rich Internet Applications (WAI-ARIA) # dom-ariamixin-ariaplaceholder |