Accessibility and React

Abbey Perini
2 min readNov 11, 2020

If you’ve ever read anything about HTML on Mozilla Developer Network, you’ve probably come across the phrase “semantic HTML.”

“Semantic HTML is the correct use of HTML to reinforce the meaning of content on a web page, rather than merely define its appearance.” — Springboard SEO

Meaning that appearance should be left to CSS (instead of using presentational HTML elements like <b>). Any developer’s goal should be to make their webpage accessible to as many users as possible, including those that rely on screen readers or keyboard navigation. Not to mention, a lot of these practices will bolster your SEO.

Semantic HTML has a lot of built in features to take some of the accessibility work off of the developer. For instance, a <button> is automatically keyboard accessible! Some of the HTML that should always be included in a page is pretty straightforward — a title for your page, alt text for images that convey information, and make sure to include your headings and labels. All menus, forms, and inputs should be set up for keyboard navigation. Most importantly, a page should be sectioned using HTML sectioning elements or appropriate ARIA Landmarks (e.g. a <div> or a <span> should be your last resort).

This is all fairly easy to adhere to when you’re creating static pages or multiple mustache-express views, but what happens when you hit single page apps like React?

In React, multiple elements can be rendered at the same time as long as they’re all children of one parent element. As a result, the common method is to throw all of them in <div> within <div> within <div>.

There are a few common sense steps to take right off the bat:

  • Read the React accessibility documentation.
  • Remember that the for attribute is htmlFor in JSX.
  • Use <section>, <article>, <label>, headings, and aria-label liberally.
  • Use buttons to handle onClick events.
  • Use links for navigation.
  • Always test your page with a screen reader and keyboard navigation to see if you need to switch around tags to make navigation and focus possible.

In addition, really get to know the handy tools React has to help you: Fragments and Refs. Fragments can help you declutter your containers, while still inserting components wherever you need to. Refs can be used to manage focus for keyboard and mobile navigation (and insert a page title after rendering — titles are always read by screen readers).

Finally, audit your React app with react-axe and eslint-plugin-jsx-a11y.

If tackling accessibility still seems like a huge hurdle, checkout

’s POUR principles!