Element: ariaPlaceholder-Eigenschaft
Baseline
2023
Neu verfügbar
Seit October 2023 funktioniert diese Funktion auf aktuellen Geräten und in aktuellen Browserversionen. Auf älteren Geräten oder in älteren Browsern funktioniert sie möglicherweise nicht.
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 |