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

BCD tables only load in the browser

Siehe auch