Dialogs
The v-dialog
component inform users about a specific task and may contain critical information, require decisions, or involve multiple tasks. Use dialogs sparingly because they are interruptive.
Usage
In this basic example we use the activator slot to render a button that is used to open the dialog. When using the activator slot it is important that you bind the props object from the slot (using v-bind
) to the element that will activate the dialog. See the examples below for more ways of activating a dialog.
API
Component | Description |
---|---|
v-dialog | Primary component |
Examples
Props
Activator
In addition using the activator slot, we can instead use the activator prop to activate a dialog. By placing the dialog component inside the button, and setting the activator prop value to “parent” we can designate the parent (button) as the activator.
v-model
You can also trigger a dialog by simply updating the v-model, without using either activator slot or prop. In this case, the dialog will not appear to be activated by any specific element, and will simply appear in the middle of the screen.
Fullscreen
Due to limited space, full-screen dialogs may be more appropriate for mobile devices than dialogs used on devices with larger screens.
Transitions
You can make the dialog appear from the top or the bottom.
Persistent
Persistent dialogs are not dismissed when touching outside or pressing the esc key.
Scrollable
Example of a dialog with scrollable content.
Misc
Form
A simple example of a form in a dialog.
Loader
The v-dialog
component makes it easy to create a customized loading experience for your application.
Nesting
Dialogs can be nested: you can open one dialog from another.
Overflowed
Modals that do not fit within the available window space will scroll the container.