Skip to main content
WCAGrules
Quick navigation

ACT Rule 5f99a7

ARIA attribute is defined in WAI-ARIA

ARIA attributes are a fixed list. This rule checks that every aria- attribute on the page is one that actually exists in the specification. Nearly every failure is a typo, and a misspelled ARIA attribute is silently ignored by the browser, so the label you thought you wrote never reached anybody.

A tool can decide this one on its own, which is why it turns up in scanner output. The rule is approved, which in W3C's process means it was implemented in full by at least one tool or methodology and then signed off by a working group. Approval is a statement about tools, not a statement that this is the settled way to test the criterion.

Why passing this rule settles nothing about WCAG

W3C's requirements mapping for this rule names no WCAG success criterion as a conformance requirement. That is the position of 24 of the 87 live rules and this is one of them, which is why a scanner can flag it while an auditor leaves it out of the findings. Both of them are reading the same page correctly.

This is the clearest case of a scanner and an auditor disagreeing while both are right. W3C gives the rule no conformance requirement at all. It lists 1.3.1 and 4.1.2 as related and says the rule is stricter than either, because some of the failing examples satisfy the criteria anyway. Fix the typo. Do not expect an audit to write it up as a WCAG failure.

Where W3C files this rule

W3C's index lists this rule under the criteria below, which is how most readers arrive here. The rule's own page names none of them as a conformance requirement, so treat the grouping as a signpost rather than as a verdict.

The normative rule text lives at W3C

What the rule applies to, and exactly what it expects, is published by W3C and can change. We link to it rather than restate it, so nothing here can quietly fall out of date against the source. Read rule 5f99a7 at W3C.

ARIA attributes have rules that must be followed

ARIA lets you tell assistive technology what something is. That only works if what you tell it is true and complete. A role often carries obligations. Some need particular states set, some need a specific parent, some need particular children.

A tab has to live in a tablist. A checkbox has to say whether it is checked. Leave those out and you have described something that does not exist. That is worse than describing nothing.

Half-finished ARIA is the pattern. Someone adds role="tablist" to get the semantics and stops there. The tabs never announce their state and the widget becomes unusable by voice.

ARIA, explained without the jargon

Fixes that satisfy it

If this rule fails on your site, these are the techniques that put it right.

Other rules W3C files under the same criteria

Each of these asks a different question about the same part of the standard. Passing all of them is still not the same as satisfying the criterion.

All 87 ACT rules are grouped by the criteria they test, and 24 of them decide nothing about WCAG on their own. Run a free scan to see which of these your own pages trip.

Go somewhere useful

Find tools, resources and your workspace.

29 destinations