Skip to content

Fix Accessibility Violations for Hyperlinks and Images on Website#1994

Open
huangkevin-apr wants to merge 1 commit intofacebook:mainfrom
huangkevin-apr:fix-a11y-link
Open

Fix Accessibility Violations for Hyperlinks and Images on Website#1994
huangkevin-apr wants to merge 1 commit intofacebook:mainfrom
huangkevin-apr:fix-a11y-link

Conversation

@huangkevin-apr
Copy link

Summary

This PR resolves 26 accessibility violations on website detected by the IBM Equal Access Accessibility Checker. The fixes address two critical WCAG compliance issues: missing accessible names for hyperlinks and missing alternative text for images.
image
Why is this important?
When an image contains important information, providing a text alternative makes the same information accessible through assistive technologies, such as a Braille display. When an image is decorative or redundant, providing correct markup allows assistive technologies to ignore or not repeat the information.

Problem

The IBM A11Y Checker identified the following violations:

  1. Hyperlinks Without Accessible Names (13 violations)
  • Rule: Hyperlinks must have an accessible name for their purpose
  • Impact: Screen reader users cannot understand the purpose or destination of links
  • WCAG Reference: WCAG 2.1 Success Criterion 2.4.4 (Link Purpose)
  1. Images Without Alternative Text (13 violations)
  • Rule: Images must have either alt text, labels, or be marked as decorative/redundant
  • Impact: Screen reader users cannot access the information conveyed by company logos
  • WCAG Reference: WCAG 2.1 Success Criterion 1.1.1 (Non-text Content)

Solution

Added Company Name Data
Extended the poweredByImages array to include a name property for each company:

{ url: "https://www.adacore.com", image: "/img/who/adacore.png", name: "Adacore" }

Updated Image Rendering
Modified the rendering logic to include descriptive alt text:
Before:

<img className={styles.poweredByImage} src={image} />

After:

<img className={styles.poweredByImage} src={image} alt={`${name} logo`} />

Testing

✅ All 26 accessibility violations resolved in IBM A11Y Checker
✅ Alt text accurately describes each logo
✅ No visual or functional changes to the UI
✅ Link purposes are now clearly communicated to assistive technologies

Fix Before
image

Fix After
image

Accessibility Impact

These changes ensure compliance with WCAG 2.1 Level A standards and improve the experience for:

  • Screen reader users: Can now identify each company logo and understand link destinations
  • Users with images disabled: Alt text provides context even when images don't load
  • Search engines: Improved semantic understanding of page content
  • Voice control users: Can reference links by their accessible names

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.

@meta-cla meta-cla bot added the CLA Signed label Jan 31, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant