ARIA state and properties are HTML attributes that are added to elements using:
aria-[state|property]=[property-type]
ARIA states define the current state of HTML elements in the accessibility tree. For example:
ARIA properties define purpose or relationships of HTML elements in the accessibility tree. For example:
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 1.3 |
|---|---|---|---|---|
aria-atomic |
Global | Global | Global | Global |
aria-braillelabel |
N/A | N/A | N/A | Global - Added in ARIA 1.1 Except where prohibited |
aria-brailleroledescription |
N/A | N/A | N/A | Global - Added in ARIA 1.1 Except where prohibited |
aria-busy (state) |
Global | Global | Global | Global |
aria-controls |
Global | Global | Global | Global |
aria-current (state) |
N/A | Global - Added in ARIA 1.1 | Global | Global |
aria-describedby |
Global | Global | Global | Global |
aria-description |
N/A | N/A | N/A | Widget - Added in ARIA 1.1 |
aria-details |
N/A | Global - Added in ARIA 1.1 | Global | Global |
aria-disabled (state) |
Global | Global | Global Deprecated from Global | Global Deprecated from Global |
aria-dropeffect |
Global | Global | Global | Global |
aria-errormessage |
N/A | Global - Added in ARIA 1.1 | Global Deprecated from Global | Global Deprecated from Global |
aria-flowto |
Global | Global | Global | Global |
aria-grabbed (state) |
Global | Global | Global | Global |
aria-haspopup |
Global | Global | Global Deprecated from Global | Global Deprecated from Global |
aria-hidden (state) |
Global | Global | Global | Global |
aria-invalid (state) |
Global | Global | Global Deprecated from Global | Global Deprecated from Global |
aria-keyshortcuts |
N/A | Global - Added in ARIA 1.1 | Global | Global |
aria-label |
Global | Global | Global | Global Except where prohibited |
aria-labelledby |
Global | Global | Global | Global Except where prohibited |
aria-live |
Global | Global | Global | Global |
aria-owns |
Global | Global | Global | Global |
aria-relevant |
Global | Global | Global | Global |
aria-roledescription |
N/A | Global - Added in ARIA 1.1 | Global | Global Except where prohibited |
Widget attributes relate to common user interface elements found on GUI systems or in rich internet applications which receive user input and process user actions.
| Widget Attributes | ARIA 1.0 | ARIA 1.1 | ARIA 1.2 | ARIA 1.3 |
|---|---|---|---|---|
aria-autocomplete |
Widget | Widget | Widget | Widget |
aria-checked |
Widget | Widget | Widget | Widget |
aria-disabled |
Widget | Widget | Widget | Widget |
aria-errormessage |
N/A | Widget - Added in ARIA 1.1 | Widget | Widget |
aria-expanded |
Widget | Widget | Widget | Widget |
aria-haspopup |
Widget | Widget | Widget | Widget |
aria-hidden |
Widget | Widget | Widget | Widget |
aria-invalid |
Widget | Widget | Widget | Widget |
aria-label |
Widget | Widget | Widget | Widget |
aria-level |
Widget | Widget | Widget | Widget |
aria-modal |
N/A | Widget - Added in ARIA 1.1 | Widget | Widget |
aria-multiline |
Widget | Widget | Widget | Widget |
aria-multiselectable |
Widget | Widget | Widget | Widget |
aria-orientation |
Widget | Widget | Widget | Widget |
aria-placeholder |
N/A | Widget - Added in ARIA 1.1 | Widget | Widget |
aria-pressed |
Widget | Widget | Widget | Widget |
aria-readonly |
Widget | Widget | Widget | Widget |
aria-required |
Widget | Widget | Widget | Widget |
aria-selected (state) |
Widget | Widget | Widget | Widget |
aria-sort |
Widget | Widget | Widget | Widget |
aria-valuemax |
Widget | Widget | Widget | Widget |
aria-valuemin |
Widget | Widget | Widget | Widget |
aria-valuenow |
Widget | Widget | Widget | Widget |
aria-valuetext |
Widget | Widget | Widget | Widget |
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 1.3 |
|---|---|---|---|---|
aria-atomic |
Live region | Live region | Live region | Live region |
aria-busy |
Live region | Live region | Live region | Live region |
aria-live |
Live region | Live region | Live region | Live region |
aria-relevant |
Live region | Live region | Live region | Live region |
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 1.3 |
|---|---|---|---|---|
aria-dropeffect |
Drag and drop | Drag and drop | Drag and drop | Drag and drop |
aria-grabbed |
Drag and drop | Drag and drop | Drag and drop | Drag and drop |
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 1.3 |
|---|---|---|---|---|
aria-activedescendant |
Relationship | Relationship | Relationship | Relationship |
aria-colcount |
N/A | Relationship - Added in ARIA 1.1 | Relationship | Relationship |
aria-colindex |
N/A | Relationship - Added in ARIA 1.1 | Relationship | Relationship |
aria-colindextext |
N/A | N/A | N/A | Relationship - Added in ARIA 1.3 |
aria-colspan |
N/A | Relationship - Added in ARIA 1.1 | Relationship | Relationship |
aria-controls |
Relationship | Relationship | Relationship | Relationship |
aria-describedby |
Relationship | Relationship | Relationship | Relationship |
aria-details |
N/A | Relationship - Added in ARIA 1.1 | Relationship | Relationship |
aria-errormessage |
Relationship | Relationship | Relationship | Relationship |
aria-flowto |
Relationship | Relationship | Relationship | Relationship |
aria-labelledby |
Relationship | Relationship | Relationship | Relationship |
aria-owns |
Relationship | Relationship | Relationship | Relationship |
aria-posinset |
Relationship | Relationship | Relationship | Relationship |
aria-rowcount |
N/A | Relationship - Added in ARIA 1.1 | Relationship | Relationship |
aria-rowindex |
N/A | Relationship - Added in ARIA 1.1 | Relationship | Relationship |
aria-rowindextext |
N/A | N/A | N/A | Relationship - Added in ARIA 1.3 |
aria-rowspan |
N/A | Relationship - Added in ARIA 1.1 | Relationship | Relationship |
aria-setsize |
Relationship | Relationship | Relationship | Relationship |