-
Notifications
You must be signed in to change notification settings - Fork 5
Closed
Labels
testsThis issue or PR is about adding, removing or changing testsThis issue or PR is about adding, removing or changing testswwwImprovements or additions to arkenv.js.orgImprovements or additions to arkenv.js.org
Description
Issue
Accessibility tests are currently disabled for the svg-img-alt rule due to violations from third-party SVG libraries.
Problem
Lucide-react and @icons-pack/react-simple-icons SVGs with role="img" are being flagged by axe-core for missing accessible text. However, these SVGs are decorative and are inside buttons/links that already have accessible labels (via aria-label or text content).
Impact: SERIOUS accessibility violation
Location
Affects multiple pages:
- Homepage (
/) - Quickstart page (
/docs/quickstart) - Main docs pages (
/docs,/docs/examples,/docs/morphs) - Integration pages (
/docs/integrations/vscode,/docs/integrations/jetbrains)
Test files:
tooling/playwright-www/tests/homepage.test.ts:216tooling/playwright-www/tests/quickstart.test.ts:198tooling/playwright-www/tests/docs-navigation.test.ts:208, 236tooling/playwright-www/tests/accessibility.test.ts:179, 214
Current Workaround
The rule is temporarily disabled in accessibility tests:
disableRules: ["svg-img-alt"]Potential Solutions
- Add aria-hidden: Mark decorative SVGs as
aria-hidden="true"since they're inside accessible buttons/links - Custom wrapper components: Create wrapper components that properly handle SVG accessibility
- Remove role="img": If possible, configure libraries to not add
role="img"for decorative icons - Add aria-label to SVGs: Add descriptive aria-labels directly to the SVG elements (though this may be redundant if parent has label)
Related
This is tracked in accessibility tests with:
// TODO: Fix svg-img-alt - lucide-react and icons-pack SVGs with role="img" inside accessible buttons/links
// These SVGs are decorative and inside buttons/links with accessible labelsReactions are currently unavailable
Metadata
Metadata
Assignees
Labels
testsThis issue or PR is about adding, removing or changing testsThis issue or PR is about adding, removing or changing testswwwImprovements or additions to arkenv.js.orgImprovements or additions to arkenv.js.org