ElementInternals: ariaValueText-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 ariaValueText-Eigenschaft des ElementInternals-Interfaces spiegelt den Wert des aria-valuetext-Attributs wider, das den in menschlicher Sprache lesbaren Text als Alternative für aria-valuenow bei einem Bereichs-Widget definiert.

Hinweis: Das Setzen von aria-Attributen auf ElementInternals ermöglicht es, Standard-Semantiken für ein benutzerdefiniertes Element zu definieren. Diese können von Autoren durch definierte Attribute überschrieben werden, stellen jedoch sicher, dass die Standard-Semantiken beibehalten werden, falls der Autor diese Attribute löscht oder gar nicht hinzufügt. Weitere Informationen finden Sie in der Accessibility Object Model explainer.

Wert

Ein String.

Beispiele

In diesem Beispiel wird der Wert von ariaValueText auf "Sunday" gesetzt.

js
class CustomControl extends HTMLElement {
  constructor() {
    super();
    this.internals_ = this.attachInternals();
    this.internals_.ariaValueText = "Sunday";
  }
  // …
}

Spezifikationen

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

Browser-Kompatibilität