Jake Archibald
Read post

Fixing my tooltip accessibility mistake

A web developer shares an accessibility mistake made when building a tooltip for an icon-only button. The error was removing aria-label and relying solely on aria-describedby, which provides additional description but not an accessible name. Without an accessible name, screen readers like JAWS incorrectly announced nearby sibling elements. The fix was switching to aria-labelledby, which provides the accessible name from the tooltip element. Key takeaways: always ensure interactive elements have an accessible name, and test with multiple screen readers rather than just one.

    #accessibility
Jul 28•4m read time•From jakearchibald.com
Post cover image
Table of contents
What I didWhere I went wrongThe fix
7.2K Impressions
Jake Archibald's image
Jake Archibald

JakeArchibald provides insights into web performance optimization and frontend development best prac...

11 Followers

•

101 Upvotes

Would you recommend this post?

Copy link
WhatsApp
Facebook
X
New Squad
  • © 2026 Daily Dev Ltd.
  • Guidelines
  • Explore
  • Tags
  • Sources
  • Squads
  • Leaderboard