Skip to content

[Button] Missing accessible name for icon-only button #874

Open
@coseeian

Description

@coseeian

Title

[Button] Missing accessible name for icon-only button

Description

The icon-only button on the page is missing any accessible name, so screen readers announce only its role (e.g., “button”) without any descriptive label. As a result, users will not be able to identify the purpose or function of the button.

Steps to Reproduce

page 1

  1. go to /
  2. Locate to the following element:
    #hideBanner (CSS Selector)
    (This issue is since to be a global issue)

page 2

  1. go to /reference/
  2. Locate to the following element:
    #main-content > div.mx-0 > astro-island > div > div.h-0.overflow-visible > div > div > button
    (This issue is since to be a global issue)

Actual Behavior

  • When tabbing to the button, a screen reader announces only “button” without any label or description.
  • There is no visible text or tooltip associated with the button.

Expected Behavior

  • The button should expose an accessibility name
  • When tabbing to the button, A screen reader should announce a meaningful labe.

Environments

No response

Suggested Fix

Add an accessibility name to the button, for example:

<button aria-label="action">
  <svg …></svg>
</button>

Alternatively, include visually hidden text inside the button:

<button>
  <span class="visually-hidden">action</span>
  <svg …></svg>
</button>

Reference

WCAG:4.1.2 Name, Role, Value
WCAG-T:F68: Failure of Success Criterion 4.1.2 due to a user interface control not having a programmatically determined name
APG:Providing Accessible Names and Descriptions

What is your operating system?

None

Web browser and version

No response

Metadata

Metadata

Assignees

No one assigned

    Labels

    Accessibility: High SeverityWeb accessibility issues that have a significant negative impact on users

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions