methodology / Accessibility / #57

ARIA labels presence and validity

live factor #57 · Accessibility · scoring impl: implemented · weight 0.7%

What we measure

ARIA labels give screen readers context for icon buttons, custom widgets, and interactive elements. Missing or invalid ARIA breaks the experience for blind users.

How to improve your score

Use semantic HTML where possible (`<button>` instead of `<div role="button">`); add `aria-label` to icon-only buttons; double-check that any `role` you add matches the element's actual behavior.

Data source

Data source for this factor is not yet documented.

Implementation notes

Lint HTML for missing `aria-label` on icon-only controls, invalid `role` values, and orphaned `aria-labelledby` references.

Scoring

Scoring formulas are versioned with the methodology. The current method (v1.1.0) maps raw measurements to pass, warn, fail. Factor weights determine how much each contributes to the composite — see the methodology index for the full table.

Version history

← back to methodology