ElementInternals: ariaRequired-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 ariaRequired-Eigenschaft der ElementInternals-Schnittstelle spiegelt den Wert des aria-required-Attributs wider, welches angibt, dass eine Benutzereingabe auf dem Element erforderlich ist, bevor ein Formular abgeschickt werden kann.

Hinweis: Das Festlegen von aria-Attributen auf ElementInternals ermöglicht es, die Standardsemantik eines benutzerdefinierten Elements zu definieren. Diese können von benutzerdefinierten Attributen überschrieben werden, stellen jedoch sicher, dass die Standardsemantik beibehalten wird, falls der Autor diese Attribute löscht oder sie überhaupt nicht hinzufügt. Weitere Informationen finden Sie im Accessibility Object Model explainer.

Wert

Ein String mit einem der folgenden Werte:

"true"

Benutzer müssen eine Eingabe auf einem Element machen, bevor ein Formular abgeschickt wird.

"false"

Benutzereingabe ist nicht notwendig, um das Formular abzuschicken.

Beispiele

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

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

Spezifikationen

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

Browser-Kompatibilität

Siehe auch