Forms without an accessible name are not exposed as ARIA landmarks

stefanjudis

Stefan Judis

Posted on July 19, 2024

Forms without an accessible name are not exposed as ARIA landmarks

Suppose you want to be a good web citizen; you use semantic and accessible HTML. Elements "leading places" are a elements, your navigation lives in a nav element, buttons are ... well ... buttons, and your form controls are surrounded by a good old form.

Using the correct elements gives your HTML meaning. Semantic markup helps machines understand what they're dealing with. Googlebot slurping in your site will understand the important sections of your articles because it finds their headings. Assistive technology like screen readers can offer features and a better UX to navigate your site. Throw away the div soup and go for semantic HTML. It's great stuff!

For example, I can fire up VoiceOver on my Mac and navigate my site via all the exposed ARIA landmark regions exposed from semantic HTML.

Voice over showing the landmarks available on stefanjudis.com

banner maps to the header element, navigation is the nav element. And if an element has an accessible name, it's also listed next to its ARIA role. Good stuff!

If you look at the navigation landmark, I added the accessible names of Main and Footer because the page has two nav elements. The articles are enriched with their title, too.

But hold on! I know that there's a form on the page. Why isn't the newsletter signup form shown in the landmarks overview from VoiceOver?

As a first step, I opened the devtools to inspect the accessibility panel.

Accessibility panel of Chrome DevTools highlighting that the form has a role of

role=generic? My form element didn't come with an accessible form role but generic? I feel betrayed.

A quick look at the ARIA specs unveils the answer.

ARIA specification highlighting that

A form is not exposed as landmark region unless it has been provided an accessible name.

Wow! If you're not setting accessible names on your forms, they won't have the form role, which means they're not marked as forms and thus hard to discover and inaccessible.

How can you provide an accessible name?

There are many different ways, and each depends on the element.

A heading, for example, receives its accessible name from its content. Easy. Form controls receive it from their connected label. Label your inputs, folks! It really depends on the element. If you're curious and want to learn more, read the guide "Providing Accessible Names and Descriptions". But what about forms, then?

Here's a bit more guidance from the WAI-ARIA 1.3 spec:

Authors MUST give each element with role form a brief label that describes the purpose of the form. Authors SHOULD reference a visible label with aria-labelledby if a visible label is present. Authors SHOULD include the label inside of a heading whenever possible.

That makes a lot of sense. If you build up a form, there should be something nearby telling what this form is about. If it is, you can connect the form with the element representing its purpose via aria-labelledby and provide a nice accessible name.

<form aria-labelledby="form-heading">
  <h2 id="form-heading">Newsletter sign up</h2>
  <!-- more form stuff -->
</form>
Enter fullscreen mode Exit fullscreen mode

If you can't include a visual heading for "reasons", you can also fall back to providing a string value via aria-label. But note that a form including a visual explanation of what it's about comes with a better user experience, and aria-label may also break if folks use in-browser translations.

<form aria-label="Newsletter sign up">
  <!-- more form stuff -->
</form>
Enter fullscreen mode Exit fullscreen mode

With these tweaks, my form now shows up in VoiceOver, is enriched with an accessible name and has a proper form role.

VoiceOver and Chrome accessibility devtools showing the form with a proper

Success!

💖 💪 🙅 🚩
stefanjudis
Stefan Judis

Posted on July 19, 2024

Join Our Newsletter. No Spam, Only the good stuff.

Sign up to receive the latest update from our blog.

Related