Skip to content

Conversation

@huangkevin-apr
Copy link

@huangkevin-apr huangkevin-apr commented Jan 10, 2026

Description

This PR fixes 6 accessibility violations identified by the IBM Equal Access Accessibility Checker, where SVG elements were missing accessible names in violation of WCAG 1.1.1 (Non-text Content).

Problem

Screen readers were attempting to announce decorative icon elements that lacked proper accessibility attributes. The affected icons include:

  • Chevron-down icon in the "Software" dropdown menu
  • External link icons next to "Plugins" and "Docs" navigation links
  • Social media icons for Discord, GitHub, and Twitter

Screenshot:
1
Violation Report:
image

In all cases, these icons are purely decorative and accompany text labels or are within elements that already have proper aria-label attributes. For example, these a elements provide aria-label to describe the icon, so we should keep these svg elements are marked aria-hidden="true" :
image

Solution

Added aria-hidden="true" to all decorative <Icon> components. This attribute instructs screen readers to ignore these SVG elements, preventing redundant and confusing announcements while maintaining visual design.

Changes Made

  • IconButton.astro: Added aria-hidden="true" to social media icons (Discord, GitHub, Twitter)
  • NavBar.astro: Added aria-hidden="true" to external link icons for "Plugins" and "Docs"
  • NavDropDown.astro: Added aria-hidden="true" to the chevron icon in dropdown menu

WCAG Compliance

This fix ensures compliance with:

  • WCAG 1.1.1 (Level A): Non-text Content
  • All decorative images are now properly hidden from assistive technologies

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.

1 participant