ElementInternals: ariaReadOnly-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 ariaReadOnly-Eigenschaft des ElementInternals-Interfaces spiegelt den Wert des aria-readonly-Attributs wider, welches angibt, dass das Element nicht bearbeitet, aber dennoch bedient werden kann.

Hinweis: Das Setzen von aria-Attributen auf ElementInternals ermöglicht es, Standardsemantiken auf einem benutzerdefinierten Element zu definieren. Diese können durch vom Autor definierte Attribute überschrieben werden, jedoch wird sichergestellt, dass die Standardsemantik beibehalten wird, falls der Autor diese Attribute entfernt oder sie überhaupt nicht hinzufügt. Für weitere Informationen siehe den Accessibility Object Model Erklärer.

Wert

Ein String mit einem der folgenden Werte:

"true"

Der Benutzer kann den Wert des Elements nicht ändern.

"false"

Der Benutzer kann den Wert des Elements festlegen.

Beispiele

In diesem Beispiel wird der Wert von ariaReadOnly auf "true" gesetzt.

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

Spezifikationen

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

Browser-Kompatibilität

Siehe auch