Skip to main content

Module accessibility

Module accessibility 

Source
Expand description

Automated WCAG accessibility checker. Automated WCAG accessibility checker and ARIA validation plugin.

Validates generated HTML against a subset of WCAG 2.2 Level AA success criteria and checks ARIA landmark correctness. Produces two artifacts in the site directory:

  • accessibility-report.json — issue list per page (existing format).
  • wcag-compliance.json — compliance matrix mapping each WCAG 2.2 criterion to its automation status (automated / runtime-only / manual / not-applicable) plus a per-page pass/fail summary.

Build-time checks:

  • 1.1.1 Non-text content (<img alt>)
  • 1.3.1 Heading hierarchy (no skipped levels)
  • 2.3.1 Banned elements (<marquee>, <blink>)
  • 2.4.4 Link purpose (discernible text or aria-label)
  • 2.4.13 Focus appearance — :focus { outline: none } without compensating style is flagged (WCAG 2.2 addition)
  • 2.5.8 Target size minimum — explicit width/height < 24 px on interactive selectors flagged (WCAG 2.2 addition)
  • 3.1.1 Page language (<html lang>)
  • 3.2.6 Consistent help — informational note when help link absent from page (WCAG 2.2 addition; full check requires cross-page analysis, see runtime axe-core gate)
  • ARIA landmarks (single <main>, <nav aria-label>)

Structs§

AccessibilityIssue
An individual accessibility issue found in a page.
AccessibilityPlugin
Plugin that checks generated HTML for WCAG compliance.
AccessibilityReport
Full accessibility report.
CriterionEntry
One row of the WCAG 2.2 compliance matrix.
PageReport
Accessibility report for a single page.
WcagComplianceReport
WCAG 2.2 compliance matrix written alongside accessibility-report.json.

Enums§

CriterionStatus
How a single WCAG criterion is verified.