Menu Component
Menu items trigger an immediate action within the current page.
A menu may contain menu item, menu item radio() or menu item checkbox commands.
A menu is appropriate when requiring a partial page re-render without using a form or full page reload. For example: filtering and sorting of search results.
A menu is not appropriate for a full page reload. For that, please use links instead (see the Fake Menu pattern). The distinction between menu items and links is important! A menu item is a command that executes JavaScript, whereas a link is a command that navigates to a url. If your menu must contain a mix of JavaScript behaviour and links behaviour, please use a list of buttons and links. Do no mix menu items and links.
A menu is not a form control. If you wish to submit form data natively, without JavaScript, please consider checkbox , combobox , select , or radio instead.
Selecting a menu item command should update the page without a full page reload (i.e. acting similar to buttons, checkboxes or radios). If a full page load is required instead (i.e. acting like links), please refer to the fake menu .
Terminology
We use the following terminology when discussing this pattern.
- menu : the pattern as a whole, comprising the parts listed below
- command list : the list of menu items
- command : the individual menu item, menu item checkbox or menu item radio commands