Skip to content

Fix: Simplify accessible names for social media icons#16

Merged
brookslybrand merged 1 commit intoremix-run:mainfrom
huangkevin-apr:fix-a11y-svg
Jan 13, 2026
Merged

Fix: Simplify accessible names for social media icons#16
brookslybrand merged 1 commit intoremix-run:mainfrom
huangkevin-apr:fix-a11y-svg

Conversation

@huangkevin-apr
Copy link
Contributor

Summary

This PR addresses 3 accessibility violations identified by IBM Equal Access Accessibility Checker related to social media icons on website homepage. The fix simplifies SVG <title> elements to match their visible label text, ensuring consistency between visual and accessible content per WCAG Level A requirements.

Problem

The accessibility checker identified that accessible names for social media icons did not match their visible label text:

  • Twitter icon: <title>Twitter Logo</title> doesn't match visible text "Twitter"
  • GitHub icon: <title>GitHub Logo</title> doesn't match visible text "GitHub"
  • YouTube icon: <title>YouTube logo</title> doesn't match visible text "YouTube"
image

**Issue: **According to WCAG 2.5.3 (Label in Name), when components have visible text labels, the accessible name should contain or match the visible text. Adding "Logo" or "logo" creates a mismatch that can confuse users, especially those using voice control who say "click Twitter" but the accessible name is "Twitter Logo."

Solution

Simplified all SVG <title> elements to exactly match their visible labels by removing the "Logo"/"logo" suffix:

// Before
<title>Twitter Logo</title>
<title>GitHub Logo</title>
<title>YouTube logo</title>

// After
<title>Twitter</title>
<title>GitHub</title>
<title>YouTube</title>

Fix After:
image

This ensures:

  • Accessible names match visible labels exactly
  • Voice control users can activate icons using the visible text
  • Screen reader announcements are concise and match visual expectations
  • Consistency across all social media icons

Testing

✅ Verified with IBM Equal Access Accessibility Checker
✅ All 3 accessible name mismatch violations resolved

Additional Info

The patch submitted in this PR was generated by A11YRepair, an automated Web Accessibility repair tool that I developed to address common accessibility violations in web applications. The generated fixes were manually reviewed and validated before submission.

@brookslybrand brookslybrand merged commit 8976235 into remix-run:main Jan 13, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants

Comments