Add aria-* to HTML attributes index table

[TGianella]

Description

Add a new aria-* row to the HTML attributes table. The attribute name link points to https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes. This family of attributes is a bit of an outlier regarding the Element column because members don't all apply to the same set of elements, hence the phrasing "Depends on the specific attribute".

I also struggled to find a good page to link to in the description. Understanding ARIA Basics looked good but it is a learn page and not a reference so it might not be exactly what users are looking for. In the end I went for ARIA Guides even though it's not only related to ARIA attributes.

Motivation

ARIA attributes are HTML attributes so they need to be mentioned in the HTML attributes table.

Additional details

Related issues and pull requests

Closes #44079

[github-actions]

Preview URLs (2 pages)

• /en-US/docs/Web/HTML/Guides
• /en-US/docs/Web/HTML/Reference/Attributes

Flaws (35)

Note! 1 document with no flaws that don't need to be listed. 🎉

Found an unexpected or unresolvable flaw? Please report it here.

URL: /en-US/docs/Web/HTML/Reference/Attributes
Title: HTML attribute reference
Flaw count: 35

• broken_links:
  • Link /en-US/docs/Web/HTML/Reference/Attributes/alt doesn't resolve
  • Link /en-US/docs/Web/Accessibility/ARIA/ is a redirect
  • Link /en-US/docs/Web/HTML/Reference/Attributes/autoplay doesn't resolve
  • Link /en-US/docs/Web/HTML/Reference/Attributes/cite doesn't resolve
  • Link /en-US/docs/Web/HTML/Reference/Attributes/colspan doesn't resolve
  • and 30 more flaws omitted

(comment last updated: 2026-05-13 09:23:18)

[estelle]

Thank you for the PR.

To address the issue, we should also add a mention of ARIA within the HTML gides page. As that page is created by listing a summary of the guides i the HTML directory, we can address the issue by adding a "see also" section and adding a link to ARIA there.

[estelle]

I think "All elements" might be better here, because every element can accept at least one aria-* attribute, like aria-atomic.

[TGianella]

Agree but isn't it going to cause a bit of confusion as to what the difference is between "All elements" and "Global attribute"?

[estelle]

The role attribute is global, and some aria-* attributes are too, but not all. Maybe @dipikabh has thoughts or even a better wording option.

[TGianella]

role already has a dedicated row in the HTML attributes table so we're only talking about proper aria-* attributes. Your point still stands about not all of them being global.

[TGianella]

I committed with "All elements" for the time being since I think it is still better than what I had first written.

[russell-aciss]

Don't we want to tell people what "ARIA" is before sending them there? We could maybe change "ARIA Guides" to "Accessibility Guides" or "Accessibility Guides and Attributes".