Element: ariaPlaceholder-Eigenschaft
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Oktober 2023 browserübergreifend verfügbar.
Die ariaPlaceholder-Eigenschaft der Element-Schnittstelle spiegelt den Wert des aria-placeholder-Attributs wider, das einen kurzen Hinweis angibt, 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 eingebaute Semantik besitzen und keine ARIA-Attribute erfordern.
Wert
Ein String.
Beispiele
In diesem Beispiel wurde das aria-placeholder-Attribut des Elements mit der ID txtBoxInput auf einen String gesetzt. Mit ariaPlaceholder aktualisieren wir den String auf einen anderen Wert.
<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>
let el = document.getElementById("txtBoxInput");
console.log(el.ariaPlaceholder); // "5-digit zip code"
el.ariaPlaceholder = "12345";
console.log(el.ariaPlaceholder); // "12345"
Spezifikationen
| Spezifikation |
|---|
| Accessible Rich Internet Applications (WAI-ARIA) # dom-ariamixin-ariaplaceholder |