F Kitchen Sink

Accessibility audit rules

React A11Y Role

Accessibility rule handbook metadata

Rule
DET.A11Y.KS.REACT_A11Y_ROLE · lane deterministic · scope ks
Page status
current
page_version
12d277513ddd47bcd5d56388d2b97acc85845382a7ff036038a4fa2107964811
generated_at
2026-05-26T08:51:23.000Z
registry_fingerprint
e11a2939d018a45bae7d6e23364aba2ae4e13f190d942f49891c89ea84c44c46

How this rule is checked

Deterministic lane — scope ks. Detected by det-a11y-ks-*.check.js or the axe lane for WCAG-tagged violations.

  • Harness: auditor-tests/invoke-a11y-ruleset-harness.sh on the Before fixture.
  • Audit: analyze-website-a11y.mjs --only-deterministic-rule-ids DET.A11Y.KS.REACT_A11Y_ROLE

Module: docs/design/a11y-audit/deterministic-a11y-rules.md#det-a11y-ks-react-a11y-role. See Before / After below.

Purpose

Deterministic accessibility check (ks scope).

Passing signals

  • DOM and/or repo signals satisfy the rule implementation in tools/website-a11y-auditor.
  • For axe-backed WCAG criteria, use --lanes axe,det with an appropriate --standard preset.

Failing signals

  • Auditor emits a finding with ruleId DET.A11Y.KS.REACT_A11Y_ROLE on the crawled URL.
  • Harness: auditor-tests/invoke-a11y-ruleset-harness.sh DET.A11Y.KS.REACT_A11Y_ROLE expects ≥1 finding on the Before fixture.

Before example

Before (failing example)

Placeholder failing state for DET.A11Y.KS.REACT_A11Y_ROLE (ks).

After example

After (passing example)

Placeholder passing state for DET.A11Y.KS.REACT_A11Y_ROLE.

Evidence and remediation

  1. Reproduce with analyze-website-a11y.mjs --only-deterministic-rule-ids DET.A11Y.KS.REACT_A11Y_ROLE when lane is deterministic.
  2. Apply the After markup pattern (or fix generator source for KS rules).
  3. Re-run harness or audit until the rule is clean on the target URL.