aria-pressed attribute | ariaPressed property
Sets or retrieves the pressed state of a button that can be toggled.
![]() |
Syntax
| HTML |
|---|
<element aria-pressed="p" ... > |
| JavaScript |
|---|
object.setAttribute("aria-pressed",value);var value = object.getAttribute("aria-pressed");
|
Property values
Type: String
The pressed state.
-
The element is down (button pressed).
-
The element is up.
-
The element indicates both pressed and unpressed states.
-
Default. The element state is unknown.
Standards information
- Accessible Rich Internet Applications (WAI-ARIA) 1.0, Section 6.6
Remarks
| Used in Roles |
|
|---|
Buttons with a defined aria-pressed state can be toggled. (When aria-pressed is true the button is down, when false it is up.) Simple command buttons should not define a aria-pressed state.
Note The presence of the aria-pressed attribute affects the behavior of accessibility and automation tools. The attribute should not be used carelessly.
Note For cross-browser compatibility, always use the WAI-ARIA attribute syntax to access and modify ARIA properties, for example
object.setAttribute("aria-valuenow", newValue). See also
Show:
