Accessibility rule handbook metadata
- Rule
DET.A11Y.KS.REACT_A11Y_ROLE· lanedeterministic· scopeks- Page status
- current
- page_version
e66f9bd49f597887b73159e9ea92e073dbc1bbe400f10e08f6c2d6825367dc0b- generated_at
- 2026-05-28T05:09:12.000Z
- registry_fingerprint
b3797010c3ca988bb0d21d5e85d4efece0b9e83f311c2d4981ebbf402df7a7c2
Related WCAG success criteria
Indicative mapping for compliance reporting — not a conformance claim. Criteria: 4.1.2
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.shon 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,detwith an appropriate--standardpreset.
Failing signals
- Auditor emits a finding with
ruleIdDET.A11Y.KS.REACT_A11Y_ROLEon the crawled URL. - Harness:
auditor-tests/invoke-a11y-ruleset-harness.sh DET.A11Y.KS.REACT_A11Y_ROLEexpects ≥1 finding on the Before fixture.
Before example
Before (failing example)
React A11Y Role
DOM or content signals fail DET.A11Y.KS.REACT_A11Y_ROLE (react a11y role).
Rule: DET.A11Y.KS.REACT_A11Y_ROLE · scope: ks
After example
After (passing example)
React A11Y Role (remediated)
DOM and content satisfy DET.A11Y.KS.REACT_A11Y_ROLE after remediation.
Deterministic accessibility check (ks scope).
Evidence and remediation
- Reproduce with
analyze-website-a11y.mjs --only-deterministic-rule-ids DET.A11Y.KS.REACT_A11Y_ROLEwhen lane is deterministic. - Apply the After markup pattern (or fix generator source for KS rules).
- Re-run harness or audit until the rule is clean on the target URL.
Related rules
- See deterministic-a11y-rules.md
DET.A11Y.GENERIC.LANG— Root html must declare lang.
Related WCAG
- WCAG 4.1.2 —
wcag/2.2/sc/4.1.2-name-role-value.md