Material Components React Drawer
npm install closure-react-drawerA React version of an MDC Drawer.
``
npm install @material/react-drawer
with Sass:
`js`
import '@material/react-drawer/index.scss';
with CSS:
`js`
import "@material/react-drawer/dist/drawer.css";
#### Basic Usage
Below is the basic example of a drawer. is not defined, but can be any element. Guidelines state it should be navigational content. Typically it is a list.
`js
import React, {Component} from 'react';
import Drawer from '@material/react-drawer';
class MyApp extends Component {
render() {
return (
);
}
}
`
#### Header and Content Variant
You may want to include a header, which MDC Web has already styled for you. For convenience, we've included , , , and components. DrawerHeader and DrawerContent default to a
tag, while the DrawerTitle and DrawerSubtitle default to an h3 and h6 tag respectively, but can be customized with the tag prop (example shown below).`js
import React, {Component} from 'react';
import Drawer, {
DrawerHeader,
DrawerSubtitle,
DrawerTitle,
DrawerContent,
} from '@material/react-drawer';class MyApp extends Component {
render() {
return (
{/defaults to div/}
{/defaults to h3/}
Inbox
{/defaults to h6/}
matt@email.com
{/defaults to div/}
);
}
}
`#### Dismissible Variant
The 2 previous examples are both permanent drawer examples, which are stationary. If you have a smaller screen, or want to keep focus on your main content you may want to use a dismissible drawer. The dismissible drawer will expand and collapse based on the
prop.You will also want to use the
component, which will wrap around your content, that should animate in/out with the dismissible drawer.`js
import React, {Component} from 'react';
import Drawer, {DrawerAppContent} from '@material/react-drawer';class MyApp extends Component {
state = {open: false};
render() {
return (
open={this.state.open}
>
Your really cool app content here
);
}
}
`#### Usage with Top App Bar
##### Full height drawer
If you want the dismissible drawer or permanent drawer to appear to the side of the top app bar (take the full height of the screen) as shown in the below image, please follow this markup:
js
import React, {Component} from 'react';
import TopAppBar, {TopAppBarFixedAdjust} from '@material/react-top-app-bar';
import Drawer, {DrawerAppContent, DrawerContent, DrawerHeader, DrawerTitle} from '@material/react-drawer';
import MaterialIcon from '@material/react-material-icon';
import List, {ListItem, ListItemGraphic, ListItemText} from '@material/react-list';// includes imports for drawer, list, material icon and top app bar styles
import './App.scss';
export default class App extends Component {
state = {selectedIndex: 0};
render() {
return (
jane.smith@gmail.com
Your inbox content
);
}
}`You will also need these styles:
css.drawer-container {
display: flex;
flex-direction: row;
height: 100vh;
overflow: hidden;
}
.drawer-app-content {
flex: auto;
overflow: auto;
}
`##### Dismissible or Permanent drawer below top app bar
If you want the dismissible drawer or permanent drawer to appear below the top app bar as shown in the below image, please follow this markup:
js
import React, {Component} from 'react';
import TopAppBar, {TopAppBarFixedAdjust} from '@material/react-top-app-bar';
import Drawer, {DrawerAppContent, DrawerContent, DrawerHeader, DrawerTitle} from '@material/react-drawer';
import MaterialIcon from '@material/react-material-icon';
import List, {ListItem, ListItemGraphic, ListItemText} from '@material/react-list';// includes imports for drawer, list, material icon and top app bar styles
import './App.scss';
export default class App extends Component {
state = {selectedIndex: 0};
render() {
return (
jane.smith@gmail.com
Your inbox content
);
}
}`You will also need these styles:
css
.drawer-container {
display: flex;
flex-direction: row;
height: 100vh;
overflow: hidden;
}.drawer-app-content {
flex: auto;
overflow: auto;
}
`There is a known issue with the dismissible drawer styles when putting the drawer below the top app bar. To get around this, you must update the
class in your CSS stylesheets.`css
.mdc-drawer--dismissible {
top: auto;
}
`> _NOTE_: Ordering of the markup is imperative.
#### Modal Variant
If you are on a smaller screen and do not want to animation your content, you may want to use the modal drawer. The modal drawer will expand and collapse based on the
prop overlayed your application content.You should also implement the
onClose callback prop, which is triggered after the drawer closes. This is your opportunity to set the open state variable to false.> NOTE: Closes with
esc key or scrim click.`js
import React, {Component} from 'react';
import Drawer, {DrawerAppContent} from '@material/react-drawer';class MyApp extends Component {
state = {open: false};
render() {
return (
open={this.state.open}
onClose={() => this.setState({open: false})}
>
Your really cool app content here
);
}
}
`$3
#### Focus Management
It is recommended to shift focus to the first focusable element in the main content when drawer is closed or one of the destination items is activated. (By default, MDC React Drawer restores focus to the menu button which opened it.)
> _NOTE_: There is also a known bug due to the use of
into your drawer as a workaround.#### Dismissible Drawer
Restore focus to the first focusable element when a list item is activated or after the drawer closes. Do not close the drawer upon item activation, since it should be up to the user when to show/hide the dismissible drawer.
`js
import React, {Component} from 'react';
import Drawer from '@material/react-drawer';
import Button from '@material/react-button';class Drawer extends Component {
mainContentEl = React.createRef();
focusFistFocusableItem = () => {
this.mainContentEl.current.querySelector('input, button').focus();
}
onDrawerClose = () => {
this.setState({open: false});
this.focusFistFocusableItem();
}
render() {
return (
open={this.state.open}
onClose={this.drawerOnClose}
>
);
}
}
`#### Modal Drawer
Close the drawer when an item is activated in order to dismiss the modal as soon as the user performs an action. Only restore focus to the first focusable element in the main content after the drawer is closed, since it's being closed automatically.
js
import React, {Component} from 'react';
import Drawer from '@material/react-drawer';
import Button from '@material/react-button';class Drawer extends Component {
mainContentEl = React.createRef();
onDrawerClose = () => {
this.setState({open: false});
this.mainContentEl.current.querySelector('input, button').focus();
}
onListItemClick = () => this.onDrawerClose();
render() {
return (
open={this.state.open}
onClose={this.drawerOnClose}
>
);
}
}
`Props
$3
Prop Name | Type | Description
--- | --- | ---
className | String | Classes to be applied to the drawer element.
onOpen | Function() => void | Callback after the drawer has opened.
onClose | Function() => void | Callback after the drawer has closed.
modal | Boolean | Indicates that the drawer is of type modal.
dismissible | Boolean | Indicates that the drawer is of type dismissible.
tag | String | Customizes the drawer tag type (default to