Skip to content

A11y: Links missing accessible names #21

@marcuskbra

Description

@marcuskbra

Description

Some links in the application do not have accessible names, failing the link-name axe-core rule.

Current Behavior

Links may contain only images without alt text, or have no text content, making them inaccessible to screen reader users.

Expected Behavior

All links should have accessible names through one of:

  • Text content within the link
  • aria-label attribute
  • aria-labelledby reference
  • Image with alt text inside the link
<!-- Good examples -->
<a href="/lesson">View Lesson</a>
<a href="/lesson" aria-label="View Lesson 1">
  <img src="icon.svg" alt="">
</a>

Impact

  • Screen reader users hear "link" without knowing the destination
  • Users cannot understand the purpose of links

WCAG Criterion

Suggested Fix

  1. Audit all links in the application
  2. Add text content or aria-label to links
  3. For icon-only links, add aria-label describing the action

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions