Bottom sheets
The bottom sheet is a modified v-dialog
that slides from the bottom of the screen, similar to a v-bottom-navigation
.
This feature requires v3.3.0 (Icarus)
Usage
Whereas a bottom navigation component is for buttons and specific application level actions, a bottom sheet is meant to contain anything.
API
Component | Description |
---|---|
v-bottom-sheet | Primary Component |
Anatomy
The recommended components to use inside of a v-bottom-sheet
are:
Element / Area | Description |
---|---|
1. Container | The bottom sheet is a dialog that animates from the bottom of the screen |
Guide
The v-bottom-sheet
component is a modified v-dialogthat slides from the bottom of the screen. It is used for elevating content above other elements in a dialog style fashion. The bottom sheet can be controlled using the v-model
prop or through the activator
slot.
The following code snippet is an example of a basic v-bottom-sheet
component:
<v-bottom-sheet>
<v-card
title="Bottom Sheet"
text="Lorem ipsum dolor sit amet consectetur, adipisicing elit. Ut, eos? Nulla aspernatur odio rem, culpa voluptatibus eius debitis."
></v-card>
</v-bottom-sheet>
Props
The v-bottom-sheet
component has access to all of the props available in v-dialog.
Model
The v-model (or model-value) controls the visibility of the bottom sheet:
This also works in tandem with the activatorslot.
Inset
With the inset prop, reduce the maximum width of the content area on desktop to 70%. This can be further reduced manually using the width prop.
Slots
The v-bottom-sheet
component has access to all of the slots available in v-dialog.
Slot | Description |
---|---|
1. Default | The default slot |
2. Activator | The activator slot is used to open the bottom sheet |
The activator slot is not required when using the v-model prop.
Examples
The following are a collection of examples that demonstrate more advanced and real world use of the v-bottom-sheet
component.
Music Player
Using a inset bottom sheet, you can make practical components such as this simple music player.
Open In List
By combining a functional list into a bottom sheet, you can create a simple ‘open in’ component.