Eureka Engineering
Published in

Eureka Engineering

Some Common ARIA Properties for Accessible Web UI Components

This is the December 10 article for Eureka Advent Calendar 2021.

For building accessible web UI components, using an existing UI component library always seem to be the fastest option. If you are using a framework like React, there are many great UI component libraries with accessible features built-in like Headless UI, Radix UI, and Reach UI.

However, sometimes you might need to build accessible components on your own. For example when your tech stack doesn’t fit well with these UI libraries, or you need to build some components that are not supported by these libraries. In such cases, you will have to add ARIA properties to support assistive technologies like screen readers and manage keyboard navigation.

In this article, I will be introducing some ARIA properties that I think are commonly used. Then show several actual code examples by Design Patterns and Widgets under WAI-ARIA Authoring Practices that use those ARIA properties.

Common ARIA Properties


The role attribute indicates what kind of widget is the component. It tells assistive technologies like screen readers how to handle the component.

For example, when you add role="alert" to an element, as long as the text content inside the element changes, screen readers will usually announce the text.

However, in many cases, the role attribute alone is not enough to convey all necessary accessibility information. This is when other ARIA properties that look like aria-* come in.

But since there is a large number of different aria-* properties, it might be a bit overwhelming at the beginning of learning web accessibility. So here I list up a few properties that are usually seen in the WAI-ARIA widget design patterns.


The aria-label and aria-labelledby attributes provide labels for the UI component.

The difference between the two attributes is that aria-label directly defines a string value to label the component, while aria-labelledby identifies an element that labels the component. It is recommended to use aria-labelledby if the label text is visible on the screen.

For example, when you have a radio group component that is labeled by a text component with id="radio_group_label", you can add aria-labelledby="radio_group_label" to the radio group component.


The aria-disabled attribute indicates an interactive component is not editable or operable.

For example, when you have a switch component that represents a feature that is not available to the current user, you can add a aria-disabled="true" to the switch component.

aria-checked, aria-selected

The aria-checked and aria-selected attributes both indicate the “checked” and “selected” state of a component.

For example, when you have a switch component, you can add aria-checked="true" to it to indicate that it is checked. Or when you have a list box component, you can add aria-selected="true" to an option component to indicate whether that option is selected.

aria-haspopup, aria-controls, aria-expanded

For more complicated components that have one interactive element (like a button) that controls another element’s visibility (like a dropdown menu), aria-haspopup, aria-expanded, and aria-controls attributes can be pretty helpful.

  • The aria-haspopup attribute indicates that the component can trigger a popup component.
  • The aria-controls attribute indicates that a component can control another component’s contents or presence
  • The aria-expanded attribute indicates that whether the component controlled by the current component is expanded (visible)

For example, when you have a button that can show and hide a dropdown menu component, and the dropdown menu component has a id="dropdown_menu", you can add aria-haspopup="true" and aria-controls="dropdown_menu" to the button component. And if the dropdown menu is visible, you can add aria-expanded="true" to the button component.

UI Component Examples

Now let’s look at some examples provided by WAI-ARIA widget design patterns that use the ARIA attributes introduced above.


The simplest example might be an alert component. An alert is a component that displays information that attracts the user’s attention.

It only requires a role="alert" to the alert component.

Here is the code from the WAI-ARIA alert example:

Alert component example code


A switch is an input component that allows users to switch between “on” and “off”. It requires role and several aria-* attributes.

The switch container has the following attributes:

  • role="alert"
  • aria-checked="true" (or "false"): Indicates whether the switch is checked or not.

The on/off labels have the following attributes:

  • aria-hidden="true": Because the screen reader can already announce the check state by looking at the aria-checked attribute on the switch container, we add aria-hidden="true" to disable redundant screen reader announcement on the label text.

Here is the code from the WAI-ARIA switch example:

Switch component example code


Tabs are just like the tabs in your browser. They require a combination of multiple components that use role and aria-* attributes.

The tab container has the following attributes:

  • role="tablist"
  • aria-label/aria-labelledby: Describes the purpose of the tabs.

Each tab button has the following attributes:

  • role="tab"
  • aria-selected="true" (or "false"): Indicates whether the tab is selected or not.
  • aria-controls: Refers to the tab panel controlled by this tab button by passing the tab panel’sid.
  • id: The ID to be referred by the tab panel’s aria-labelledby.

Each tab panel has the following attributes:

  • role="tabpanel"
  • aria-labelledby: Refers to the tab button associated with this tab panel by assigning the tab button’s id.
  • id: The ID to be referred by the tab button’s aria-controls.

Here is the code from the WAI-ARIA tab example:

Tab component example code

Dropdown Menu

A dropdown menu component is a popup UI that offers a set of actions. It requires a combination of multiple components that use role and aria-* attributes.

The menu button component has the following attributes:

  • aria-haspopup="true": Indicates that it opens a pop-up menu.
  • aria-controls: Refers to the menu controlled by this menu button by assigning the menu’sid.
  • aria-expanded="true": Indicates whether the menu is visible or not. This attribute is removed when the menu is closed.
  • id: The ID to be referred by the menu’s aria-labelledby.

The menu component has the following attributes:

  • role="menu"
  • aria-labelledby: Refers to the menu button associated with this menu by assigning the menu button’s id.
  • id: The ID to be referred by the menu button’s aria-controls.

The menu item component has the following attributes:

  • role="menuitem"

Here is the code from the WAI-ARIA menu button example:


Using the appropriate ARIA attributes is a big step towards building your own accessible UI components. In this article, I have introduced several ARIA attributes that I think are commonly used and also walked through the attributes used in real WAI-ARIA example components.

There are still many more WAI-ARIA roles and attributes out there, if you want to have a deeper dive into this topic, take a look at MDN’s docs about roles and properties, or the WAI-ARIA specs.

One last thing to mention, I will recommend considering using native HTML elements before adding an ARIA attribute. Using ARIA state attributes like aria-checkedusually involves JavaScript, however not every user has their browser JavaScript enabled. On the other hand, HTML elements give you many great accessible features out of the box without any JavaScript. So even your user don’t want to use JavaScript, you can still provide them with good accessibility features.




Learn about Eureka’s engineering efforts, product developments and more.

Recommended from Medium

Using pipeline (case 001) — ElasticSearch

React Component Design Systems

Serve static HTML files locally

Why use a UI Library with React?

Upcoming TypeScript Changes in Vue 2.5

Testing the V8 JavaScript Engine

nothing to say😂😓

Know Everything About Angular 8 Template Driven Forms

Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store
Yuxiao He (Usho Ka)

Yuxiao He (Usho Ka)

Web front-end engineer at Eureka, Inc. Nogizaka46 driven web developer.

More from Medium

Considerations for writing React Components — Part 01: Introduction

Build an accessible “Skip to Content” anchor link with React.

Skiplink button user interface with content “Skip Navigation Links”.

Setup React Relay in an Nx Mono Repo

Infinite Scroll with TypeScript