ariaPressed property

Sets or retrieves the pressed state of a button that can be toggled.

 

Syntax

object.setAttribute("ariaPressed",value);var value = object.getAttribute("ariaPressed");

Property values

Type: BSTR

The pressed state.

(true)

The element is down (button pressed).

(false)

The element is up.

(mixed)

The element indicates both pressed and unpressed states.

(undefined)

Default. The element state is unknown.

Standards information

• Accessible Rich Internet Applications (WAI-ARIA) 1.0, Section 6.6

Remarks

Used in Roles

button

 

Buttons with a defined IHTMLElement5::ariaPressed state can be toggled. (When IHTMLElement5::ariaPressed is true the button is down, when false it is up.) Simple command buttons should not define a IHTMLElement5::ariaPressed state.

Note  The presence of the IHTMLElement5::ariaPressed 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

Accessible Rich Internet Applications (ARIA)

W3C ARIA-Pressed