Menu Accessibility
Best Practices
To avoid confusion with form-based checkboxes and radios (which have different behaviour), menuitem checkboxes and radios should be styled differently (e.g. with a tick).
Remember, a menu is not a form control. Its purpose is not to store or submit data via form submission. A menu, like a button, is a mechanism to execute JavaScript, and therefore is 100% dependent on JavaScript.
If you are concerned that the functionality of the menu must be available in a non-JavaScript state, then perhaps a menu is not the best choice. Consider form controls instead.
Adding, modifying or deleting records (e.g. CRUD) could be considered critical functionality. Filtering and sorting search results could be considered non-critical.
Selecting a command should not fully reload the page (use a fake menu instead).
Selecting a command must perform a JavaScript action on the client (e.g. AJAX request then partial page re-render).
Interaction Design
This section provides interaction design for keyboard, screen reader & pointing devices.
Keyboard
The menu itself does not receive focus; focus must go to the first item in the menu.
UP-ARROW and DOWN-ARROW keys must navigate keyboard focus through commands via roving tabindex mechanism (skipping any that are disabled).
If focus is on a command, ENTER or SPACEBAR keys must activate that command.
TAB key must move keyboard focus off menu, and onto next interactive element in the page.
Screen Reader
Commands must be announced as “menu item”, “menu item radio” or “menu item checkbox” role.
Checkbox and radio command state must be announced as checked or unchecked.
Disabled commands must be announced as disabled.
Pointer
Clicking any menu item must activate that command.
ARIA Reference
This section gives an overview of our use of ARIA, within the specific context of the menu pattern.
| Attribute | Description |
|---|---|
| role=menu | Informs assistive technology that this is a menu containing menuitems, menuitemradios or menuitemcheckboxes. |
| role=presentation | Informs assistive technology that the divs around groups of menu items are for presentation purposes only and should not be added to accessibility tree. |
| role=menuitem | Informs assistive technology that this menu command has button behaviour. |
| role=menuitemradio | Informs assistive technology that this menu command has radio button behaviour. |
| role=menuitemcheckbox | Informs assistive technology that this menu command has checkbox behaviour. |
| aria-checked | Informs assistive technology whether the menuitemradio or menuitemcheckbox is checked or not. Notice we do not use aria-selected. |