Skip to content

Website Accessibility: Redundant image alt text repeats link text on homepage #6871

Description

@huangkevin-apr

What is the current behavior?

On the Recharts official website homepage, the “Users / Companies” logo section contains multiple links where an image is wrapped inside a link and the image alt text repeats the visible link text.

Image

According to IBM Equal Access Accessibility Checker, this triggers the following accessibility violation repeatedly:

Link text is repeated in an image alt value within the same link

Example of the affected markup (as reported by the checker):

<a href="...">
  <img
    src="/assets/shadcn-ui.svg"
    alt="shadcn/ui"
    title="shadcn/ui"
  />
</a>
Image

Because the link already has an accessible name from its surrounding context or visible text, the repeated alt text causes screen readers to announce the same link text twice, which may confuse users relying on assistive technologies.

This issue is reported for multiple logos in the same section.

What is the expected behavior?

For images that are purely decorative or redundant within a link, the image should not repeat the link text in its alt attribute.

Expected accessible patterns include one of the following:

If the image is decorative and does not add new information:

<img src="..." alt="" />

If the image conveys additional information beyond the link text, the alt text should describe that additional information instead of repeating the link label.

This ensures that:

  • Screen reader users do not hear duplicate link announcements
  • The page complies with WCAG Success Criteria:
    1.1.1 Non-text Content
    2.4.4 Link Purpose (In Context)

Please provide a demo of the problem in a sandbox

This issue can be reproduced directly on the Recharts official website homepage without any custom configuration.

Steps to reproduce:

  • Open the Recharts homepage
  • Run IBM Equal Access Accessibility Checker
  • Inspect the logo/link section highlighted in the screenshots
  • Observe repeated violations of rule img_alt_redundant

Because this is a documentation/website accessibility issue rather than a chart component issue, a minimal sandbox demo is likely unnecessary. However, the violation can be demonstrated with a simplified example:

<a href="#">
  <img src="logo.svg" alt="CompanyName" />
  CompanyName
</a>

Which versions of Recharts, and which browser / OS are affected by this issue? Did this work in previous versions of Recharts?

Metadata

Metadata

Assignees

No one assigned

    Labels

    accessibilityIssues associated with accessibilitydocs neededIssues that require documentation

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions