ARIA states and properties - Accessibility | MDN (2024)

The following are the reference pages covering the WAI-ARIA states and properties discussed on MDN.

aria-activedescendant

The aria-activedescendant attribute identifies the currently active element when focus is on a composite widget, combobox, textbox, group, or application.

aria-atomic

In ARIA live regions, the global aria-atomic attribute indicates whether assistive technologies such as a screen reader will present all, or only parts of, the changed region based on the change notifications defined by the aria-relevant attribute.

aria-autocomplete

The aria-autocomplete attribute indicates whether inputting text could trigger display of one or more predictions of the user's intended value for a combobox, searchbox, or textbox and specifies how predictions will be presented if they are made.

aria-braillelabel

The global aria-braillelabel property defines a string value that labels the current element, which is intended to be converted into Braille.

aria-brailleroledescription

The global aria-brailleroledescription attribute defines a human-readable, author-localized abbreviated description for the role of an element intended to be converted into Braille.

aria-busy

Used in ARIA live regions, the global aria-busy state indicates an element is being modified and that assistive technologies may want to wait until the changes are complete before informing the user about the update.

aria-checked

The aria-checked attribute indicates the current "checked" state of checkboxes, radio buttons, and other widgets.

aria-colcount

The aria-colcount attribute defines the total number of columns in a table, grid, or treegrid when not all columns are present in the DOM.

aria-colindex

The aria-colindex attribute defines an element's column index or position with respect to the total number of columns within a table, grid, or treegrid.

aria-colindextext

The aria-colindextext attribute defines a human-readable text alternative of the numeric aria-colindex.

aria-colspan

The aria-colspan attribute defines the number of columns spanned by a cell or gridcell within a table, grid, or treegrid.

aria-controls

The global aria-controls property identifies the element (or elements) whose contents or presence are controlled by the element on which this attribute is set.

aria-current

A non-null aria-current state on an element indicates that this element represents the current item within a container or set of related elements.

aria-describedby

The global aria-describedby attribute identifies the element (or elements) that describes the element on which the attribute is set.

aria-description

The global aria-description attribute defines a string value that describes or annotates the current element.

aria-details

The global aria-details attribute identifies the element (or elements) that provide additional information related to the object.

aria-disabled

The aria-disabled state indicates that the element is perceivable but disabled, so it is not editable or otherwise operable.

aria-dropeffect

The global aria-dropeffect attribute indicates what functions may be performed when a dragged object is released on the drop target.

aria-errormessage

The aria-errormessage attribute on an object identifies the element that provides an error message for that object.

aria-expanded

The aria-expanded attribute is set on an element to indicate if a control is expanded or collapsed, and whether or not the controlled elements are displayed or hidden.

aria-flowto

The global aria-flowto attribute identifies the next element (or elements) in an alternate reading order of content. This allows assistive technology to override the general default of reading in document source order at the user's discretion.

aria-grabbed

The aria-grabbed state indicates an element's "grabbed" state in a drag-and-drop operation.

aria-haspopup

The aria-haspopup attribute indicates the availability and type of interactive popup element that can be triggered by the element on which the attribute is set.

aria-hidden

The aria-hidden state indicates whether the element is exposed to an accessibility API.

aria-invalid

The aria-invalid state indicates the entered value does not conform to the format expected by the application.

aria-keyshortcuts

The global aria-keyshortcuts attribute indicates keyboard shortcuts that an author has implemented to activate or give focus to an element.

aria-label

The aria-label attribute defines a string value that labels an interactive element.

aria-labelledby

The aria-labelledby attribute identifies the element (or elements) that labels the element it is applied to.

aria-level

The aria-level attribute defines the hierarchical level of an element within a structure.

aria-live

The global aria-live attribute indicates that an element will be updated, and describes the types of updates the user agents, assistive technologies, and user can expect from the live region.

aria-modal

The aria-modal attribute indicates whether an element is modal when displayed.

aria-multiline

The aria-multiline attribute indicates whether a textbox accepts multiple lines of input or only a single line.

aria-multiselectable

The aria-multiselectable attribute indicates that the user may select more than one item from the current selectable descendants.

aria-orientation

The aria-orientation attribute indicates whether the element's orientation is horizontal, vertical, or unknown/ambiguous.

aria-owns

The aria-owns attribute identifies an element (or elements) in order to define a visual, functional, or contextual relationship between a parent and its child elements when the DOM hierarchy cannot be used to represent the relationship.

aria-placeholder

The aria-placeholder attribute defines a short hint (a word or short phrase) intended to help the user with data entry when a form control has no value. The hint can be a sample value or a brief description of the expected format.

aria-posinset

The aria-posinset attribute defines an element's number or position in the current set of listitems or treeitems when not all items are present in the DOM.

aria-pressed

The aria-pressed attribute indicates the current "pressed" state of a toggle button.

aria-readonly

The aria-readonly attribute indicates that the element is not editable, but is otherwise operable.

aria-relevant

Used in ARIA live regions, the global aria-relevant attribute indicates what notifications the user agent will trigger when the accessibility tree within a live region is modified.

aria-required

The aria-required attribute indicates that user input is required on the element before a form may be submitted.

aria-roledescription

The aria-roledescription attribute defines a human-readable, author-localized description for the role of an element.

aria-rowcount

The aria-rowcount attribute defines the total number of rows in a table, grid, or treegrid.

aria-rowindex

The aria-rowindex attribute defines an element's position with respect to the total number of rows within a table, grid, or treegrid.

aria-rowindextext

The aria-rowindextext attribute defines a human-readable text alternative of aria-rowindex.

aria-rowspan

The aria-rowspan attribute defines the number of rows spanned by a cell or gridcell within a table, grid, or treegrid.

aria-selected

The aria-selected attribute indicates the current "selected" state of various widgets.

aria-setsize

The aria-setsize attribute defines the number of items in the current set of listitems or treeitems when not all items in the set are present in the DOM.

aria-sort

The aria-sort attribute indicates if items in a table or grid are sorted in ascending or descending order.

aria-valuemax

The aria-valuemax attribute defines the maximum allowed value for a range widget.

aria-valuemin

The aria-valuemin attribute defines the minimum allowed value for a range widget.

aria-valuenow

The aria-valuenow attribute defines the current value for a range widget.

aria-valuetext

The aria-valuetext attribute defines the human-readable text alternative of aria-valuenow for a range widget.

ARIA states and properties - Accessibility | MDN (2024)

FAQs

ARIA states and properties - Accessibility | MDN? ›

The global aria-details attribute identifies the element (or elements) that provide additional information related to the object. The aria-disabled state indicates that the element is perceivable but disabled, so it is not editable or otherwise operable.

What does ARIA mean in accessibility? ›

ARIA is a W3C specification that stands for “Accessible Rich Internet Applications.” It consists of markup that can be added to HTML in order to communicate the roles, states, and properties of user interface elements to assistive technologies (AT).

What are the three types of ARIA attributes? ›

ARIA attributes: aria-label , aria-labelledby and aria-describedby # Three ARIA attributes are very well supported by browsers and AT : aria-label , aria-labelledby and aria-describedby . They allow to add extra information to an HTML tag: aria-label , aria-labelledby allow to give an accessible name to an element.

When should you use or recommend ARIA roles or attributes to solve an accessibility issue? ›

The first rule of ARIA use is "If you can use a native HTML element or attribute with the semantics and behavior you require already built in, instead of re-purposing an element and adding an ARIA role, state or property to make it accessible, then do so."

What is an example of an ARIA property? ›

Example 1: Using aria-describedby property to describe a Close button's action. A button that functions as a 'close' button on a dialog is described elsewhere in the document. The aria-describedby property is used to associate the description with the link.

What is the difference between WCAG and ARIA? ›

WCAG is more focused on over all experience, not all criteria applicable in context of separate components, for example rule about page title. WAI-ARIA 1.1 can serve as supplemental material, but prefer HTML5 whenever possible and don't forget to test with real devices.

What are the two types of ARIA? ›

Thematic Forms
  • Aria di bravura. A fast, virtuosic aria designed to show off the singer's voice with an excess of flamboyant coloratura. ...
  • Aria Parlante. Also known as an infuriata or agitata, these are highly passionate arias. ...
  • Aria di sorbetto. Otherwise know as a sherbert or ice cream aria.

What are aria states? ›

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: Is the element checked?

How many aria properties are there? ›

There are 38 properties that can be used in ARIA. They fall into 4 categories as defined by the W3C. The categories are: Widget Attributes.

What is the difference between aria attributes and data attributes? ›

Data attributes are not exposed to the accessibility tree, while aria attributes are. It is also important to note that aria attributes also do not modify how an element looks or behaves! It is only for assistive technologies, which reads the DOM's accessibility tree.

What is the first rule of aria? ›

The Rules of ARIA

First Rule of ARIA: Don't use ARIA. Well, actually, it says "if you can use a native HTML element or attribute... then do so." So, if you need a textbox, use an input, if you need a dropdown, use a select, if you need a button, use a button.

What is the common incorrect usage of aria attributes? ›

Error 1: Inappropriate use of ARIA roles, States or Properties
  • Example 1: Remove role “button”. ...
  • Example 2: Navigation links are not menus and thus aria-haspopup attribute must not be defined for such links. ...
  • Example 3: In the case of toggle buttons, value of aria-pressed attribute should change on user interaction.
Sep 26, 2023

What are the important attributes of aria? ›

ARIA attribute types
  • aria-autocomplete.
  • aria-checked.
  • aria-disabled.
  • aria-errormessage.
  • aria-expanded.
  • aria-haspopup.
  • aria-hidden.
  • aria-invalid.
Apr 16, 2024

What is the aria required property? ›

The WAI-ARIA aria-required property indicates that user input is required before submission. The aria-required property can have values of "true" or "false". For example, if a user must fill in an address field, then aria-required is set to "true".

Why aria accessibility? ›

ARIA is a set of attributes that can be added to HTML elements to provide additional information and functionality for assistive technologies. ARIA can help make complex and interactive web content more accessible and user-friendly for people who have different abilities or disabilities.

When should we use an aria attribute? ›

ARIA is useful for revising or correcting the role of an element when a different role is necessary to expose to users. However, it is rarely in the user or author's best interest to try and use ARIA to override an interactive element, for instance a button , with a role generally exposed by a non-interactive element.

What is an ARIA used for? ›

A self-contained piece for solo voice, usually accompanied by orchestra. In opera, arias mostly appear during a pause in dramatic action when a character is reflecting on their emotions.

What is an example of an ARIA role? ›

An ARIA role attribute can be added to an element to instruct assistive technologies to treat the element as something other than its native HTML element type. For example, an <a> element with role="button" will be treated as a button, not as a link.

What does the ARIA label mean? ›

ARIA (Accessible Rich Internet Applications) labels are attributes that can be added to HTML elements to provide additional information about the element's purpose and functionality to assistive technologies, such as screen readers.

What is ARIA controls used for? ›

The aria-controls attribute creates a cause and effect relationship. It identifies the element(s) that are controlled by the current element. The "aria-controls" element should be a "button" or a "link". It still not really necessary to use a specific context formatting for your XHTML markup.

Top Articles
Latest Posts
Article information

Author: Rubie Ullrich

Last Updated:

Views: 5849

Rating: 4.1 / 5 (72 voted)

Reviews: 87% of readers found this page helpful

Author information

Name: Rubie Ullrich

Birthday: 1998-02-02

Address: 743 Stoltenberg Center, Genovevaville, NJ 59925-3119

Phone: +2202978377583

Job: Administration Engineer

Hobby: Surfing, Sailing, Listening to music, Web surfing, Kitesurfing, Geocaching, Backpacking

Introduction: My name is Rubie Ullrich, I am a enthusiastic, perfect, tender, vivacious, talented, famous, delightful person who loves writing and wants to share my knowledge and understanding with you.