@react-md/menu
v5.1.6
Published
Create menus that auto-position themselves within the viewport and adhere to the accessibility guidelines
Downloads
5,562
Maintainers
Readme
@react-md/menu
Create accessible dropdown menus that auto-position themselves to stay within the viewport. The menus are entirely navigable with a keyboard along with some additional behavior:
ArrowUp
andArrowDown
to focus the previous/nextMenuItem
that also allows wrappingHome
andEnd
to focus the first/lastMenuitem
in the menu- type the starting letters of a
MenuItem
to focus it
More information on the built-in accessibility can be found in the accessibility example on the documentation site.
Installation
npm install --save @react-md/menu
You will also need to install the following packages for their styles:
npm install --save @react-md/theme \
@react-md/typography \
@react-md/icon \
@react-md/list \
@react-md/button \
@react-md/states \
@react-md/utils
Documentation
You should check out the full documentation for live examples and more customization information, but an example usage is shown below.
Usage
import { render } from "react-dom";
import { DropdownMenu, MenuItem } from "@react-md/menu";
const App = () => (
<DropdownMenu id="example-dropdown-menu" buttonChildren="Dropdown">
<MenuItem onClick={() => console.log("Clicked Item 1")}>Item 1</MenuItem>
<MenuItem onClick={() => console.log("Clicked Item 2")}>Item 2</MenuItem>
<MenuItem onClick={() => console.log("Clicked Item 3")}>Item 3</MenuItem>
</DropdownMenu>
);
render(<App />, document.getElementById("root"));