Element: ariaPlaceholder-Eigenschaft

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.

Die ariaPlaceholder-Eigenschaft der Element-Schnittstelle spiegelt den Wert des aria-placeholder-Attributs wider, welches einen kurzen Hinweis definiert, der dem Benutzer bei der Dateneingabe helfen soll, wenn das Steuerelement keinen Wert hat.

Hinweis: Verwenden Sie nach Möglichkeit ein HTML-<input>-Element mit type="text" oder ein <textarea>, da diese integrierte Semantik haben und keine ARIA-Attribute benötigen.

Wert

Ein String.

Beispiele

In diesem Beispiel wurde das aria-placeholder-Attribut des Elements mit der ID txtBoxInput auf einen String gesetzt. Mithilfe der Eigenschaft ariaPlaceholder aktualisieren wir den String auf einen anderen Wert.

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"

Spezifikationen

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

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
ariaPlaceholder

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Siehe auch