ARIA States and Properties

Github Page

ARIA release history

New states and properties

A range of new states and properties were added to ARIA 1.1. These new states and properties have been flagged in the charts below. At this stage, no new states or properties have been added to ARIA 1.2.

State and property categories

ARIA states and properties are categorized as follows:

Widget Attributes

Widget attributes are specific to common user interface elements found on GUI systems or in rich internet applications which receive user input and process user actions. These attributes are used to support the widget roles.

Widget Attributes ARIA 1.0 ARIA 1.1 ARIA 1.2
aria-autocomplete Yes Yes Yes
aria-checked Yes Yes Yes
aria-disabled Yes Yes Yes
aria-errormessage NA New Yes
aria-expanded Yes Yes Yes
aria-haspopup Yes Yes Yes
aria-hidden Yes Yes Yes
aria-invalid Yes Yes Yes
aria-label Yes Yes Yes
aria-level Yes Yes Yes
aria-modal NA New Yes
aria-multiline Yes Yes Yes
aria-multiselectable Yes Yes Yes
aria-orientation Yes Yes Yes
aria-placeholder NA New Yes
aria-pressed Yes Yes Yes
aria-readonly Yes Yes Yes
aria-required Yes Yes Yes
aria-selected Yes Yes Yes
aria-sort Yes Yes Yes
aria-valuemax Yes Yes Yes
aria-valuemin Yes Yes Yes
aria-valuenow Yes Yes Yes
aria-valuetext Yes Yes Yes

Live Region Attributes

Live Region attributes indicate that content changes may occur without the element having focus, and to provide assistive technologies with information on how to process those content updates.

Live Region Attributes ARIA 1.0 ARIA 1.1 ARIA 1.2
aria-atomic Yes Yes Yes
aria-busy Yes Yes Yes
aria-live Yes Yes Yes
aria-relevant Yes Yes Yes

Drag-and-Drop Attributes

Drag-and-Drop attributes indicate information about drag-and-drop interface elements, such as draggable elements and their drop targets.

Drag-and-Drop Attributes ARIA 1.0 ARIA 1.1 ARIA 1.2
aria-dropeffect Yes Yes Yes
aria-grabbed Yes Yes Yes

Relationship Attributes

Relationship attributes indicate relationships or associations between elements which cannot be readily determined from the document structure.

Relationship Attributes ARIA 1.0 ARIA 1.1 ARIA 1.2
aria-activedescendant Yes Yes Yes
aria-colcount NA New Yes
aria-colindex NA New Yes
aria-colspan NA New Yes
aria-controls Yes Yes Yes
aria-describedby Yes Yes Yes
aria-details NA New Yes
aria-errormessage Yes Yes Yes
aria-flowto Yes Yes Yes
aria-labelledby Yes Yes Yes
aria-owns Yes Yes Yes
aria-posinset Yes Yes Yes
aria-rowcount NA New Yes
aria-rowindex NA New Yes
aria-rowspan NA New Yes
aria-setsize Yes Yes Yes

Global Attributes

Some states and properties are applicable to all host language elements regardless of whether a role is applied. These are defined as "Global" attributes. Global states and properties are supported by all roles and by all base markup elements.

Global Attributes ARIA 1.0 ARIA 1.1 ARIA 1.2
aria-atomic Yes Yes Yes
aria-busy Yes Yes Yes
aria-controls Yes Yes Yes
aria-current NA New Yes
aria-describedby Yes Yes Yes
aria-details NA New Yes
aria-disabled Yes Yes Yes
aria-dropeffect Yes Yes Yes
aria-errormessage NA New Yes
aria-flowto Yes Yes Yes
aria-grabbed Yes Yes Yes
aria-haspopup Yes Yes Yes
aria-hidden Yes Yes Yes
aria-invalid Yes Yes Yes
aria-keyshortcuts NA New Yes
aria-label Yes Yes Yes
aria-labelledby Yes Yes Yes
aria-live Yes Yes Yes
aria-owns Yes Yes Yes
aria-relevant Yes Yes Yes
aria-roledescription NA New Yes

Github Page