Das Attributaria-pressed gibt den aktuellen "gedrückten" Zustand eines Umschaltknopfs an.

Beschreibung

Die Hinzufügung vonaria-pressed zu einem Element mit der Rollebutton verwandelt den Button in einen Umschaltknopf. Das Attributaria-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 auftrue,false,mixed oderundefined gesetzt werden kann. Im Falle vonaria-pressed, wie bei den meisten dreiwertigen Typen, ist der Standardwertundefined.

Umschaltknöpfe erfordern einen vollständigen Drücken-und-Loslassen-Zyklus, um ihren Wert zu ändern. Einmaliges Drücken und Loslassen ändert den Wert auftrue. Wenn es erneut gedrückt und losgelassen wird, ändert sich der Wert zurück zufalse.

Ein Wert vonmixed 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 nichtaria-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 Attributaria-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

DieariaPressed-Eigenschaft, Teil derElement-Schnittstelle, spiegelt den Wert des Attributsaria-pressed wider.

ElementInternals.ariaPressed

DieariaPressed-Eigenschaft, Teil derElementInternals-Schnittstelle, spiegelt den Wert des Attributsaria-pressed wider.

Zugehörige Rollen

Verwendet in Rollen:

• button

Spezifikationen

Siehe auch

• <input type="button">
• <input type="submit">
• <button>
• aria-checked
• aria-selected