ARIA: Attribut aria-pressed
Das Attribut aria-pressed gibt den aktuellen "gedrückten" Zustand eines Umschaltknopfs an.
Beschreibung
Die Hinzufügung von aria-pressed zu einem Element mit der Rolle button verwandelt den Button in einen Umschaltknopf. Das Attribut aria-pressed ist nur für Umschaltknöpfe relevant. Es stellt den aktuellen "gedrückten" Zustand des Knopfes dar.
Der Wert ist "dreiwertig", was bedeutet, dass der Wert auf true, false, mixed oder undefined gesetzt werden kann. Im Falle von aria-pressed, wie bei den meisten dreiwertigen Typen, ist der Standardwert undefined.
Umschaltknöpfe erfordern einen vollständigen Drücken-und-Loslassen-Zyklus, um ihren Wert zu ändern. Einmaliges Drücken und Loslassen ändert den Wert auf true. Wenn es erneut gedrückt und losgelassen wird, ändert sich der Wert zurück zu false.
Ein Wert von mixed bedeutet, dass die Werte von mehr als einem durch den Knopf gesteuerten Element nicht alle denselben Wert haben.
Ändern Sie nicht den Inhalt der Beschriftung eines Umschalters, wenn sich der Zustand ändert. Wenn eine Tastenbeschriftung "Pause" sagt, ändern Sie sie nicht in "Wiedergabe", wenn sie gedrückt wird. In diesem Beispiel bleibt die Beschriftung "Pause", wenn der gedrückte Zustand wahr ist, so dass ein Screenreader etwas wie "Pause-Umschaltknopf gedrückt" sagen würde.
<button aria-pressed="false">Pause</button>
Wenn Sie möchten, dass die Beschriftung zwischen "Paused" und "Play" umschaltet, verwenden Sie nicht aria-pressed.
Die erste Regel der ARIA-Nutzung lautet: "Wenn Sie ein nativeres Feature mit der benötigten Semantik und dem benötigten Verhalten verwenden können, anstatt ein Element zweckentfremdet und mit einer ARIA-Rolle, einem Zustand oder einer Eigenschaft für die Zugänglichkeit zu versehen, dann tun Sie dies." Wenn wir die nativen HTML-Semantiken mit <button> nutzen, können wir die Beschriftung umschalten, anstatt den gedrückten Zustand zu wechseln, und benötigen das Attribut aria-pressed nicht.
Werte
false-
Der Knopf unterstützt das Gedrücksein, ist aber momentan nicht gedrückt.
mixed-
Zeigt einen gemischten Moduswert für einen dreiwertigen Umschaltknopf an.
true-
Der Knopf ist gedrückt.
undefined(Standard)-
Das Element unterstützt nicht das Gedrücktsein.
Zugehörige Schnittstellen
Element.ariaPressed-
Die
ariaPressed-Eigenschaft, Teil derElement-Schnittstelle, spiegelt den Wert des Attributsaria-pressedwider. ElementInternals.ariaPressed-
Die
ariaPressed-Eigenschaft, Teil derElementInternals-Schnittstelle, spiegelt den Wert des Attributsaria-pressedwider.
Zugehörige Rollen
Verwendet in Rollen:
Spezifikationen
| Specification |
|---|
| Accessible Rich Internet Applications (WAI-ARIA) # aria-pressed |