How to use WAI-ARIA roles correctly

Use the official WAI ARIA roles defined in the World Wide Consortium (W3C) Accessible Rich Internet Applications (WAI-ARIA) 1.1 specification.

Oscar de la Hera Gomez
Written by Oscar de la Hera Gomez
First published on 12/30/2023 at 15:57
Last Updated on 12/30/2023 at 16:19
<p>Two flowers that represent ReactJS and GatsbyJS with the text "WAI-ARIA Roles" beneath them.</p>

Use the official WAI ARIA roles defined in the World Wide Consortium (W3C) Accessible Rich Internet Applications (WAI-ARIA) 1.1 specification.

SubscribeDiscover the official WAI ARIA Role Definitions

We would like to thank Pelayo Trives Pozuelo for providing us with the official W3C specification.

When developing delasign.com, PageSpeed Insights alerted us that we were not using the correct ARIA roles across the delasign.com website.

Discover PageSpeed Insights
<p>A screenshot of PageSpeed Insights showing that we were not using the WAI ARIA roles correctly.</p>

PageSpeed Insights gave us a warning that we weren't using roles correctly.

This is because we thought we could name HTML elements using natural language that directly implied their role in the delasign.com website - this is wrong.

<p>A screenshot of the World Wide Consortium (W3C) Accessible Rich Internet Applications (WAI-ARIA) 1.1 specification that shows the WAI ARIA Role descriptions.</p>

Some of the official WAI ARIA roles defined in the World Wide Consortium (W3C) Accessible Rich Internet Applications (WAI-ARIA) 1.1 specification.

To fix this, we used the official WAI ARIA roles defined in the World Wide Consortium (W3C) Accessible Rich Internet Applications (WAI-ARIA) 1.1 specification.

Please note that WAI ARIA roles are built into React & Typescript and are known as "React.AriaRole."

Learn the official WAI ARIA Role Definitions

Looking to learn more about ReactJS and SEO ?

Search our blog to find educational content on learning ReactJS and SEO.

Search our BlogSEO Fundamentals Guide

Any Questions?

We are actively looking for feedback on how to improve this resource. Please send us a note to inquiries@delasign.com with any thoughts or feedback you may have.
SubscribeContact UsVisit our BlogView our ServicesView our Work

Partner with us

We would love to get to know you and see how we can help your organization with its goals and needs.
Let's Talk

Stay Informed

Get occasional updates about our company, research, and product launches.
Subscribe