Bottom sheet
Also known as: Slide-up panel, Bottom drawer
Resources
Properties
Property | Values | Default |
---|---|---|
Has drag handle Boolean | true | false | true |
Has title Boolean | true | false | true |
Title Text | string | Title |
Has action Boolean | true | false | true |
Swap content InstanceSwap | Any component | Placeholder |
Best practises
- Bottom sheets are for use on mobile and tablet.
- Use bottom sheets for secondary actions, that don’t require full screen attention.
- Use them to present additional options or details without navigating away from the main screen.
- Avoid stacking multiple bottom sheets.
- Make sure bottom sheets are dismissable through close button or drag handle.
When to use
When providing supplementary or contextual content without navigation away from the main screen.
If the content is too complex, requires multiple steps or involves scrolling, consider full page view instead.
If the bottom sheet would unexpectedly interrupt user's workflow, use alert or snackbar instead.
Note:
Instance swap allows using custom content in a component. Read about the feature from Figma learn.
Behaviour
Bottom sheets typically slide in from the bottom of the screen and are most commonly used on mobile devices. Bottom sheets are always modal, meaning that the bottom sheet blocks user interaction with the rest of the interface until closed.
Size
Bottom sheets typically extend across the entire screen width in mobile devices for visual stability with the rest of the content. Height of the bottom sheet adapts fluidly with the device size and content.
Size | Context |
---|---|
Compact (20-30%) | Quick actions, short summaries and previews. |
Half height (~50%) | Select menus, action confirmations with multiple options, short forms and lists. |
Full height (90-100%) | Complex forms and filters, onboarding, content editing and heavy data. |