Logo

What are you looking for?

Get help straight from our team...

Enhance interactive element accessibility

Accessibility Tips

Enhance interactive element accessibility

Provide accessible names for buttons, links, and menu items to improve screen reader users' understanding of their purpose. This enhances navigation and usability for users relying on assistive technologies.

Last updated on 11 Nov, 2025

***This document provides helpful tips to improve your site's accessibility. While it doesn’t guarantee 100% compliance, it’s a great starting point to make your website more inclusive and user-friendly.***

Identification:

  • Rule ID: aria-command-name

  • Part of: axe-core 4.10

  • Severity: Serious


Applicable Standards:

  • WCAG 2.0, 2.1, 2.2 (Level A)

  • Trusted Tester

  • EN 301 549


Impact:

Affects users who are blind, have low vision, or mobility impairments.

Core Requirement:
Elements with ARIA roles of "link", "button", or "menuitem" must have a clear, discernible text that describes their purpose or function for screen reader users.


Proper Implementation:

Ensure these elements have at least one of:

  1. Visible text content readable by screen readers

  2. A non-empty aria-label attribute

  3. An aria-labelledby attribute referencing an element with descriptive text


Examples of Correct Usage:

  1. Using visible text content:

Image
  1. Using aria-label:

Image
  1. Using aria-labelledby:

Image
  1. Using title attribute:

Image


Common Errors to Avoid:

  1. Empty element without text or ARIA labels:

Image
  1. Empty aria-label:

Image
  1. Referencing non-existent elements:

Image
  1. Referencing empty elements:

Image


Rationale:

Without proper labeling, screen reader users cannot understand the purpose or function of these interactive elements.


Evaluation Method:

The system checks all elements with roles "link", "button", or "menuitem" to verify they have a discernible, accessible name.

Did you find this article helpful?
Previous

Optimize color contrast

Next