Skip to main content
🎉 A11y Issue Detection Agent is now live! Detect accessibility issues like a WCAG expert with AI. Try now!
No Result Found
Connect & Get help from 6000+ developers on our Discord community. Ask the CommunityAsk the Community

dropdown-unreachable

Ensure that users can access and navigate dropdown menus using only a keyboard.

Rule Severity : Critical

Description

Dropdown menus must be keyboard accessible to support users who cannot use pointing devices like mouses and trackpads. If you design a menu that only responds to hover or click events without keyboard support, keyboard-only users cannot access the content within.

The dropdown-unreachable rule aligns with WCAG Success Criterion 2.1.1 (Keyboard). This criterion requires that all functionality of the content is operable through a keyboard interface.

Examples

In the following example, the dropdown menu is built using a <div> that only triggers on a mouse hover. Keyboard users cannot trigger the showMenu() function because the element is not focusable and lacks keyboard event listeners.

Incorrect Sample
Copy icon Copy

In the following corrected example, the menu uses a <button> element. Buttons are natively focusable and respond to the ‘Enter’ and ‘Space’ keys.

Correct Sample
Copy icon Copy

How to fix?

To fix violations of the dropdown-unreachable rule, follow these steps:

  • Use native HTML elements like <button> or <select> that provide built-in keyboard support.

  • Ensure the trigger element is focusable using tabindex="0" if you use a non-interactive element.

  • Add event listeners for ‘Enter’ and ‘Space’ keys to toggle the menu visibility.

  • Use ARIA attributes like aria-expanded to communicate the menu state to assistive technologies.

  • Ensure the focus moves into the menu once it opens so you can navigate the items.

Reference

We're sorry to hear that. Please share your feedback so we can do better

Contact our Support team for immediate help while we work on improving our docs.

We're continuously improving our docs. We'd love to know what you liked





Thank you for your valuable feedback

Is this page helping you?

Yes
No

We're sorry to hear that. Please share your feedback so we can do better

Contact our Support team for immediate help while we work on improving our docs.

We're continuously improving our docs. We'd love to know what you liked





Thank you for your valuable feedback!

Talk to an Expert
Download Copy Check Circle