@patternfly/patternfly

--- id: Drawer section: components beta: true cssPrefix: pf-c-drawer --- import './Drawer.css' ## Examples ### Closed panel on right (default) ```html <div class="pf-c-drawer"> <div class="pf-c-drawer__main"> <div class="pf-c-drawer__content"> <div class="pf-c-drawer__body">Lorem ipsum dolor sit amet, consectetur adipiscing elit. Phasellus pretium est a porttitor vehicula. Quisque vel commodo urna. Morbi mattis rutrum ante, id vehicula ex accumsan ut. Morbi viverra, eros vel porttitor facilisis, eros purus aliquet erat, nec lobortis felis elit pulvinar sem. Vivamus vulputate, risus eget commodo eleifend, eros nibh porta quam, vitae lacinia leo libero at magna. Maecenas aliquam sagittis orci, et posuere nisi ultrices sit amet. Aliquam ex odio, malesuada sed posuere quis, pellentesque at mauris. Phasellus venenatis massa ex, eget pulvinar libero auctor pretium. Aliquam erat volutpat. Duis euismod justo in quam ullamcorper, in commodo massa vulputate.</div> </div> <div class="pf-c-drawer__panel" hidden> <div class="pf-c-drawer__body"> <div class="pf-c-drawer__head"> <span>drawer-panel</span> <div class="pf-c-drawer__actions"> <div class="pf-c-drawer__close"> <button class="pf-c-button pf-m-plain" type="button" aria-label="Close drawer panel"> <i class="fas fa-times" aria-hidden="true"></i> </button> </div> </div> </div> </div> </div> </div> </div> ``` ### Expanded panel on right ```html <div class="pf-c-drawer pf-m-expanded"> <div class="pf-c-drawer__main"> <div class="pf-c-drawer__content"> <div class="pf-c-drawer__body">Lorem ipsum dolor sit amet, consectetur adipiscing elit. Phasellus pretium est a porttitor vehicula. Quisque vel commodo urna. Morbi mattis rutrum ante, id vehicula ex accumsan ut. Morbi viverra, eros vel porttitor facilisis, eros purus aliquet erat, nec lobortis felis elit pulvinar sem. Vivamus vulputate, risus eget commodo eleifend, eros nibh porta quam, vitae lacinia leo libero at magna. Maecenas aliquam sagittis orci, et posuere nisi ultrices sit amet. Aliquam ex odio, malesuada sed posuere quis, pellentesque at mauris. Phasellus venenatis massa ex, eget pulvinar libero auctor pretium. Aliquam erat volutpat. Duis euismod justo in quam ullamcorper, in commodo massa vulputate.</div> </div> <div class="pf-c-drawer__panel"> <div class="pf-c-drawer__body"> <div class="pf-c-drawer__head"> <span>drawer-panel</span> <div class="pf-c-drawer__actions"> <div class="pf-c-drawer__close"> <button class="pf-c-button pf-m-plain" type="button" aria-label="Close drawer panel"> <i class="fas fa-times" aria-hidden="true"></i> </button> </div> </div> </div> </div> </div> </div> </div> ``` ### Closed panel on left ```html <div class="pf-c-drawer pf-m-panel-left"> <div class="pf-c-drawer__main"> <div class="pf-c-drawer__content"> <div class="pf-c-drawer__body">Lorem ipsum dolor sit amet, consectetur adipiscing elit. Phasellus pretium est a porttitor vehicula. Quisque vel commodo urna. Morbi mattis rutrum ante, id vehicula ex accumsan ut. Morbi viverra, eros vel porttitor facilisis, eros purus aliquet erat, nec lobortis felis elit pulvinar sem. Vivamus vulputate, risus eget commodo eleifend, eros nibh porta quam, vitae lacinia leo libero at magna. Maecenas aliquam sagittis orci, et posuere nisi ultrices sit amet. Aliquam ex odio, malesuada sed posuere quis, pellentesque at mauris. Phasellus venenatis massa ex, eget pulvinar libero auctor pretium. Aliquam erat volutpat. Duis euismod justo in quam ullamcorper, in commodo massa vulputate.</div> </div> <div class="pf-c-drawer__panel" hidden> <div class="pf-c-drawer__body"> <div class="pf-c-drawer__head"> <span>drawer-panel</span> <div class="pf-c-drawer__actions"> <div class="pf-c-drawer__close"> <button class="pf-c-button pf-m-plain" type="button" aria-label="Close drawer panel"> <i class="fas fa-times" aria-hidden="true"></i> </button> </div> </div> </div> </div> </div> </div> </div> ``` ### Expanded panel on left ```html <div class="pf-c-drawer pf-m-panel-left pf-m-expanded"> <div class="pf-c-drawer__main"> <div class="pf-c-drawer__content"> <div class="pf-c-drawer__body">Lorem ipsum dolor sit amet, consectetur adipiscing elit. Phasellus pretium est a porttitor vehicula. Quisque vel commodo urna. Morbi mattis rutrum ante, id vehicula ex accumsan ut. Morbi viverra, eros vel porttitor facilisis, eros purus aliquet erat, nec lobortis felis elit pulvinar sem. Vivamus vulputate, risus eget commodo eleifend, eros nibh porta quam, vitae lacinia leo libero at magna. Maecenas aliquam sagittis orci, et posuere nisi ultrices sit amet. Aliquam ex odio, malesuada sed posuere quis, pellentesque at mauris. Phasellus venenatis massa ex, eget pulvinar libero auctor pretium. Aliquam erat volutpat. Duis euismod justo in quam ullamcorper, in commodo massa vulputate.</div> </div> <div class="pf-c-drawer__panel"> <div class="pf-c-drawer__body"> <div class="pf-c-drawer__head"> <span>drawer-panel</span> <div class="pf-c-drawer__actions"> <div class="pf-c-drawer__close"> <button class="pf-c-button pf-m-plain" type="button" aria-label="Close drawer panel"> <i class="fas fa-times" aria-hidden="true"></i> </button> </div> </div> </div> </div> </div> </div> </div> ``` ### Closed panel on bottom ```html <div class="pf-c-drawer pf-m-panel-bottom"> <div class="pf-c-drawer__main"> <div class="pf-c-drawer__content"> <div class="pf-c-drawer__body">Lorem ipsum dolor sit amet, consectetur adipiscing elit. Phasellus pretium est a porttitor vehicula. Quisque vel commodo urna. Morbi mattis rutrum ante, id vehicula ex accumsan ut. Morbi viverra, eros vel porttitor facilisis, eros purus aliquet erat, nec lobortis felis elit pulvinar sem. Vivamus vulputate, risus eget commodo eleifend, eros nibh porta quam, vitae lacinia leo libero at magna. Maecenas aliquam sagittis orci, et posuere nisi ultrices sit amet. Aliquam ex odio, malesuada sed posuere quis, pellentesque at mauris. Phasellus venenatis massa ex, eget pulvinar libero auctor pretium. Aliquam erat volutpat. Duis euismod justo in quam ullamcorper, in commodo massa vulputate. <br /> <br />Lorem ipsum dolor sit amet, consectetur adipiscing elit. Phasellus pretium est a porttitor vehicula. Quisque vel commodo urna. Morbi mattis rutrum ante, id vehicula ex accumsan ut. Morbi viverra, eros vel porttitor facilisis, eros purus aliquet erat, nec lobortis felis elit pulvinar sem. Vivamus vulputate, risus eget commodo eleifend, eros nibh porta quam, vitae lacinia leo libero at magna. Maecenas aliquam sagittis orci, et posuere nisi ultrices sit amet. Aliquam ex odio, malesuada sed posuere quis, pellentesque at mauris. Phasellus venenatis massa ex, eget pulvinar libero auctor pretium. Aliquam erat volutpat. Duis euismod justo in quam ullamcorper, in commodo massa vulputate.</div> </div> <div class="pf-c-drawer__panel" hidden> <div class="pf-c-drawer__body"> <div class="pf-c-drawer__head"> <span>drawer-panel</span> <div class="pf-c-drawer__actions"> <div class="pf-c-drawer__close"> <button class="pf-c-button pf-m-plain" type="button" aria-label="Close drawer panel"> <i class="fas fa-times" aria-hidden="true"></i> </button> </div> </div> </div> </div> </div> </div> </div> ``` ### Expanded panel on bottom ```html <div class="pf-c-drawer pf-m-panel-bottom pf-m-expanded"> <div class="pf-c-drawer__main"> <div class="pf-c-drawer__content"> <div class="pf-c-drawer__body">Lorem ipsum dolor sit amet, consectetur adipiscing elit. Phasellus pretium est a porttitor vehicula. Quisque vel commodo urna. Morbi mattis rutrum ante, id vehicula ex accumsan ut. Morbi viverra, eros vel porttitor facilisis, eros purus aliquet erat, nec lobortis felis elit pulvinar sem. Vivamus vulputate, risus eget commodo eleifend, eros nibh porta quam, vitae lacinia leo libero at magna. Maecenas aliquam sagittis orci, et posuere nisi ultrices sit amet. Aliquam ex odio, malesuada sed posuere quis, pellentesque at mauris. Phasellus venenatis massa ex, eget pulvinar libero auctor pretium. Aliquam erat volutpat. Duis euismod justo in quam ullamcorper, in commodo massa vulputate. <br /> <br />Lorem ipsum dolor sit amet, consectetur adipiscing elit. Phasellus pretium est a porttitor vehicula. Quisque vel commodo urna. Morbi mattis rutrum ante, id vehicula ex accumsan ut. Morbi viverra, eros vel porttitor facilisis, eros purus aliquet erat, nec lobortis felis elit pulvinar sem. Vivamus vulputate, risus eget commodo eleifend, eros nibh porta quam, vitae lacinia leo libero at magna. Maecenas aliquam sagittis orci, et posuere nisi ultrices sit amet. Aliquam ex odio, malesuada sed posuere quis, pellentesque at mauris. Phasellus venenatis massa ex, eget pulvinar libero auctor pretium. Aliquam erat volutpat. Duis euismod justo in quam ullamcorper, in commodo massa vulputate.</div> </div> <div class="pf-c-drawer__panel"> <div class="pf-c-drawer__body"> <div class="pf-c-drawer__head"> <span>drawer-panel</span> <div class="pf-c-drawer__actions"> <div class="pf-c-drawer__close"> <button class="pf-c-button pf-m-plain" type="button" aria-label="Close drawer panel"> <i class="fas fa-times" aria-hidden="true"></i> </button> </div> </div> </div> </div> </div> </div> </div> ``` ### Expanded inline panel ```html <div class="pf-c-drawer pf-m-inline pf-m-expanded"> <div class="pf-c-drawer__main"> <div class="pf-c-drawer__content"> <div class="pf-c-drawer__body">Lorem ipsum dolor sit amet, consectetur adipiscing elit. Phasellus pretium est a porttitor vehicula. Quisque vel commodo urna. Morbi mattis rutrum ante, id vehicula ex accumsan ut. Morbi viverra, eros vel porttitor facilisis, eros purus aliquet erat, nec lobortis felis elit pulvinar sem. Vivamus vulputate, risus eget commodo eleifend, eros nibh porta quam, vitae lacinia leo libero at magna. Maecenas aliquam sagittis orci, et posuere nisi ultrices sit amet. Aliquam ex odio, malesuada sed posuere quis, pellentesque at mauris. Phasellus venenatis massa ex, eget pulvinar libero auctor pretium. Aliquam erat volutpat. Duis euismod justo in quam ullamcorper, in commodo massa vulputate.</div> </div> <div class="pf-c-drawer__panel"> <div class="pf-c-drawer__body"> <div class="pf-c-drawer__head"> <span>drawer-panel</span> <div class="pf-c-drawer__actions"> <div class="pf-c-drawer__close"> <button class="pf-c-button pf-m-plain" type="button" aria-label="Close drawer panel"> <i class="fas fa-times" aria-hidden="true"></i> </button> </div> </div> </div> </div> </div> </div> </div> ``` ### Expanded inline panel on left ```html <div class="pf-c-drawer pf-m-inline pf-m-panel-left pf-m-expanded"> <div class="pf-c-drawer__main"> <div class="pf-c-drawer__content"> <div class="pf-c-drawer__body">Lorem ipsum dolor sit amet, consectetur adipiscing elit. Phasellus pretium est a porttitor vehicula. Quisque vel commodo urna. Morbi mattis rutrum ante, id vehicula ex accumsan ut. Morbi viverra, eros vel porttitor facilisis, eros purus aliquet erat, nec lobortis felis elit pulvinar sem. Vivamus vulputate, risus eget commodo eleifend, eros nibh porta quam, vitae lacinia leo libero at magna. Maecenas aliquam sagittis orci, et posuere nisi ultrices sit amet. Aliquam ex odio, malesuada sed posuere quis, pellentesque at mauris. Phasellus venenatis massa ex, eget pulvinar libero auctor pretium. Aliquam erat volutpat. Duis euismod justo in quam ullamcorper, in commodo massa vulputate.</div> </div> <div class="pf-c-drawer__panel"> <div class="pf-c-drawer__body"> <div class="pf-c-drawer__head"> <span>drawer-panel</span> <div class="pf-c-drawer__actions"> <div class="pf-c-drawer__close"> <button class="pf-c-button pf-m-plain" type="button" aria-label="Close drawer panel"> <i class="fas fa-times" aria-hidden="true"></i> </button> </div> </div> </div> </div> </div> </div> </div> ``` ### Static ```html <div class="pf-c-drawer pf-m-expanded pf-m-static"> <div class="pf-c-drawer__main"> <div class="pf-c-drawer__content"> <div class="pf-c-drawer__body">Static drawers don't have interactive elements. Lorem ipsum dolor sit amet, consectetur adipiscing elit. Phasellus pretium est a porttitor vehicula. Quisque vel commodo urna. Morbi mattis rutrum ante, id vehicula ex accumsan ut. Morbi viverra, eros vel porttitor facilisis, eros purus aliquet erat, nec lobortis felis elit pulvinar sem. Vivamus vulputate, risus eget commodo eleifend, eros nibh porta quam, vitae lacinia leo libero at magna. Maecenas aliquam sagittis orci, et posuere nisi ultrices sit amet. Aliquam ex odio, malesuada sed posuere quis, pellentesque at mauris. Phasellus venenatis massa ex, eget pulvinar libero auctor pretium. Aliquam erat volutpat. Duis euismod justo in quam ullamcorper, in commodo massa vulputate.</div> </div> <div class="pf-c-drawer__panel"> <div class="pf-c-drawer__body"> <div class="pf-c-drawer__head"> <span>drawer-panel</span> <div class="pf-c-drawer__actions"> <div class="pf-c-drawer__close"> <button class="pf-c-button pf-m-plain" type="button" aria-label="Close drawer panel"> <i class="fas fa-times" aria-hidden="true"></i> </button> </div> </div> </div> </div> </div> </div> </div> ``` ### Stacked content body elements ```html <div class="pf-c-drawer pf-m-expanded"> <div class="pf-c-drawer__main"> <div class="pf-c-drawer__content"> <div class="pf-c-drawer__body">content-body</div> <div class="pf-c-drawer__body pf-m-padding">content-body with padding</div> <div class="pf-c-drawer__body">content-body</div> </div> <div class="pf-c-drawer__panel"> <div class="pf-c-drawer__body"> <div class="pf-c-drawer__head"> <div class="pf-c-drawer__actions"> <div class="pf-c-drawer__close"> <button class="pf-c-button pf-m-plain" type="button" aria-label="Close drawer panel"> <i class="fas fa-times" aria-hidden="true"></i> </button> </div> </div>drawer-panel</div> </div> <div class="pf-c-drawer__body pf-m-no-padding">drawer-panel with no padding</div> <div class="pf-c-drawer__body">drawer-panel</div> </div> </div> </div> ``` ### Modified content padding ```html <div class="pf-c-drawer pf-m-expanded"> <div class="pf-c-drawer__main"> <div class="pf-c-drawer__content"> <div class="pf-c-drawer__body pf-m-padding"> <b>Drawer content padding.</b> Lorem ipsum dolor sit amet, consectetur adipiscing elit. Phasellus pretium est a porttitor vehicula. Quisque vel commodo urna. Morbi mattis rutrum ante, id vehicula ex accumsan ut. Morbi viverra, eros vel porttitor facilisis, eros purus aliquet erat, nec lobortis felis elit pulvinar sem. Vivamus vulputate, risus eget commodo eleifend, eros nibh porta quam, vitae lacinia leo libero at magna. Maecenas aliquam sagittis orci, et posuere nisi ultrices sit amet. Aliquam ex odio, malesuada sed posuere quis, pellentesque at mauris. Phasellus venenatis massa ex, eget pulvinar libero auctor pretium. Aliquam erat volutpat. Duis euismod justo in quam ullamcorper, in commodo massa vulputate.</div> </div> <div class="pf-c-drawer__panel"> <div class="pf-c-drawer__body"> <div class="pf-c-drawer__head"> <span>drawer-panel</span> <div class="pf-c-drawer__actions"> <div class="pf-c-drawer__close"> <button class="pf-c-button pf-m-plain" type="button" aria-label="Close drawer panel"> <i class="fas fa-times" aria-hidden="true"></i> </button> </div> </div> </div> </div> </div> </div> </div> ``` ### Modified panel padding ```html <div class="pf-c-drawer pf-m-expanded"> <div class="pf-c-drawer__main"> <div class="pf-c-drawer__content"> <div class="pf-c-drawer__body">Lorem ipsum dolor sit amet, consectetur adipiscing elit. Phasellus pretium est a porttitor vehicula. Quisque vel commodo urna. Morbi mattis rutrum ante, id vehicula ex accumsan ut. Morbi viverra, eros vel porttitor facilisis, eros purus aliquet erat, nec lobortis felis elit pulvinar sem. Vivamus vulputate, risus eget commodo eleifend, eros nibh porta quam, vitae lacinia leo libero at magna. Maecenas aliquam sagittis orci, et posuere nisi ultrices sit amet. Aliquam ex odio, malesuada sed posuere quis, pellentesque at mauris. Phasellus venenatis massa ex, eget pulvinar libero auctor pretium. Aliquam erat volutpat. Duis euismod justo in quam ullamcorper, in commodo massa vulputate.</div> </div> <div class="pf-c-drawer__panel"> <div class="pf-c-drawer__body"> <div class="pf-c-drawer__head"> <span>drawer-panel</span> <div class="pf-c-drawer__actions"> <div class="pf-c-drawer__close"> <button class="pf-c-button pf-m-plain" type="button" aria-label="Close drawer panel"> <i class="fas fa-times" aria-hidden="true"></i> </button> </div> </div> </div> </div> </div> </div> </div> ``` ### Modified panel width ```html <div class="pf-c-drawer pf-m-expanded"> <div class="pf-c-drawer__main"> <div class="pf-c-drawer__content"> <div class="pf-c-drawer__body">Lorem ipsum dolor sit amet, consectetur adipiscing elit. Phasellus pretium est a porttitor vehicula. Quisque vel commodo urna. Morbi mattis rutrum ante, id vehicula ex accumsan ut. Morbi viverra, eros vel porttitor facilisis, eros purus aliquet erat, nec lobortis felis elit pulvinar sem. Vivamus vulputate, risus eget commodo eleifend, eros nibh porta quam, vitae lacinia leo libero at magna. Maecenas aliquam sagittis orci, et posuere nisi ultrices sit amet. Aliquam ex odio, malesuada sed posuere quis, pellentesque at mauris. Phasellus venenatis massa ex, eget pulvinar libero auctor pretium. Aliquam erat volutpat. Duis euismod justo in quam ullamcorper, in commodo massa vulputate.</div> </div> <div class="pf-c-drawer__panel pf-m-width-75 pf-m-width-33-on-lg pf-m-width-25-on-2xl"> <div class="pf-c-drawer__body"> <div class="pf-c-drawer__head"> <span>drawer-panel</span> <div class="pf-c-drawer__actions"> <div class="pf-c-drawer__close"> <button class="pf-c-button pf-m-plain" type="button" aria-label="Close drawer panel"> <i class="fas fa-times" aria-hidden="true"></i> </button> </div> </div> </div> </div> </div> </div> </div> ``` ### Additional section above main ```html <div class="pf-c-drawer pf-m-expanded"> <div class="pf-c-drawer__section">drawer-section</div> <div class="pf-c-drawer__main"> <div class="pf-c-drawer__content"> <div class="pf-c-drawer__body">Lorem ipsum dolor sit amet, consectetur adipiscing elit. Phasellus pretium est a porttitor vehicula. Quisque vel commodo urna. Morbi mattis rutrum ante, id vehicula ex accumsan ut. Morbi viverra, eros vel porttitor facilisis, eros purus aliquet erat, nec lobortis felis elit pulvinar sem. Vivamus vulputate, risus eget commodo eleifend, eros nibh porta quam, vitae lacinia leo libero at magna. Maecenas aliquam sagittis orci, et posuere nisi ultrices sit amet. Aliquam ex odio, malesuada sed posuere quis, pellentesque at mauris. Phasellus venenatis massa ex, eget pulvinar libero auctor pretium. Aliquam erat volutpat. Duis euismod justo in quam ullamcorper, in commodo massa vulputate.</div> </div> <div class="pf-c-drawer__panel"> <div class="pf-c-drawer__body"> <div class="pf-c-drawer__head"> <span>drawer-panel</span> <div class="pf-c-drawer__actions"> <div class="pf-c-drawer__close"> <button class="pf-c-button pf-m-plain" type="button" aria-label="Close drawer panel"> <i class="fas fa-times" aria-hidden="true"></i> </button> </div> </div> </div> </div> </div> </div> </div> ``` ## Documentation ### Accessibility | Attribute | Applied to | Outcome | | ----------------------- | -------------------------- | ---------------------------------------------------------------- | | `aria-expanded="true"` | `action that opens drawer` | Indicates that the expandable content is visible. **Required** | | `aria-expanded="false"` | `action that opens drawer` | Indicates that the expandable content is hidden. **Required** | | `hidden` | `.pf-c-drawer__panel` | Hides the drawer panel from assistive technologies. **Required** | ### Usage | Class | Applied to | Outcome | | --------------------------------------------------------- | ----------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `.pf-c-drawer` | `<div>` | Initiates the drawer container. **Required** | | `.pf-c-drawer__section` | `<div>` | Initiates a drawer section area. This element can be used above or below `.pf-c-drawer__main` for titles, toolbars, footers, etc. | | `.pf-c-drawer__main` | `<div>` | Initiates the drawer main area. **Required** | | `.pf-c-drawer__content` | `<div>` | Initiates the drawer content container. **Required** | | `.pf-c-drawer__panel` | `<aside>` | Initiates the drawer panel container. **Required** | | `.pf-c-drawer__body` | `<div>` | Initiates a drawer body container and is the child of `.pf-c-drawer__content` and `.pf-c-drawer__panel`. **Required** | | `.pf-c-drawer__head` | `<div>` | Initiates a drawer head container. This container positions `.pf-c-drawer__actions`, if present. | | `.pf-c-drawer__actions` | `<div>` | Identifies the drawer close button. | | `.pf-c-drawer__close` | `<div>` | Identifies the drawer close button. | | `.pf-m-panel-left` | `.pf-c-drawer` | Modifies the drawer panel to expand from the left. | | `.pf-m-panel-bottom` | `.pf-c-drawer` | Modifies the drawer panel to expand from the bottom. **Note:** percentage based panel sizes require the drawer component's parent element have an implicit or explicit height. | | `.pf-m-expanded` | `.pf-c-drawer` | Modifies the drawer panel for the expanded state. | | `.pf-m-static{-on-[lg, xl, 2xl]}` | `.pf-c-drawer` | Modifies the drawer panel state to always show both content and panel. | | `.pf-m-inline{-on-[lg, xl, 2xl]}` | `.pf-c-drawer` | Modifies the drawer so the content element and panel element are displayed side by side. `.pf-m-inline` used without a breakpoint will default to the `md` breakpoint. | | `.pf-m-no-border` | `.pf-c-drawer__panel` | Modifies the drawer panel border treatment to disable all border treatment. | | `.pf-m-padding` | `.pf-c-drawer__body` | Modifies the element to add padding. | | `.pf-m-no-padding` | `.pf-c-drawer__body` | Modifies the element to remove padding. | | `.pf-m-no-background` | `.pf-c-drawer__section`, `.pf-c-drawer__content`, `.pf-c-drawer__panel` | Modifies the drawer body/panel background color to transparent. | | `.pf-m-width-{25, 33, 50, 66, 75, 100}{-on-[breakpoint]}` | `.pf-c-drawer__panel` | Modifies the drawer panel width. |