WQI.web​qualityindex
Method v1.2.0 86 live / 86 total factors methodology

methodology / Accessibility / #57

ARIA labels presence and validity

#57 · Recommended · Web Quality · weighted · Accessibility · weight 0.7% · impl implemented · method v1.2.0

Web Quality factor

This factor is part of Web Quality — the weighted 0..100 score that sits above Web Standards. Its weight depends on what kind of site is being measured. Web Standards items take priority; this factor only enters the score once Web Standards passes.

Base weight
0.7 applied to every site type unless overridden below
Why this weight
ARIA labels matter most on app-like and form-heavy sites.

Per-site-type overrides

Site type Weight Δ vs base
E-commerce 0.8 +0.1
Education 0.9 +0.2
Government 1.0 +0.3
SaaS / Product 0.9 +0.2

Site types not listed inherit the base weight.

Same factor, two depths.

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.

Facts

Ticket
WEBQ-57
Category
Accessibility
Status
live
Weight
0.7%
Data source
Service cost
Free HTML parsing
Scoring impl
implemented
Method version
v1.2.0

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.2.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.

Cited by these standards

Standards in the Standards Library whose satisfiedBy requirement tree references this factor. Each link goes to the standard's full entry — methodology, scope, and the other factors it relies on.

Version history

Version Change Date
v1.2.0 Factor introduced. Status: live. Scoring impl: implemented. 2026-04-25

← back to methodology