Toolbars
The v-toolbar component is pivotal to any graphical user interface (GUI), as it generally is the primary source of site navigation.
Usage
<v-toolbar title="Toolbar"></v-toolbar>API
| Component | Description |
|---|---|
| v-toolbar | Primary Component |
| v-toolbar-items | Sub-component used to modify the styling of v-btn |
| v-toolbar-title | Sub-component used to display the title of the toolbar |
| v-btn | Sub-component commonly used in v-toolbar |
Caveats
When v-btns with the icon prop are used inside of v-toolbar and v-app-bar they will automatically have their size increased and negative margin applied to ensure proper spacing according to the Material Design Specification. If you choose to wrap your buttons in any container, such as a div, you will need to apply negative margin to that container in order to properly align them.
Guide
A toolbar is a flexible container that can be used in a number of ways. By default, the toolbar is 64px high on desktop and 56px high on mobile. There are a number of helper components available to use with the toolbar. The v-toolbar-title is used for displaying a title and v-toolbar-items allow v-btn to extend full height.
Props
The toolbar has a number of props that can be used to modify its appearance and behavior.
Dense toolbars
Dense toolbars reduce their height to 48px.
Collapse
Toolbars can be collapsed to save screen space.
Background
Toolbars can display a background as opposed to a solid color using the src prop. This can be modified further by using the img slot and providing your own v-img component. Backgrounds can be faded using a v-app-bar
Location
You can use location prop to control how the toolbar is positioned within a relative container. It can also be used with position-fixed class instead of absolute prop.
Extended
Toolbars can be extended without using the extension slot.
Extension height
The extension’s height can be customized.
Slots
The toolbar has a number of slots that can be used to customize its content.
Extension
The extension slot can be used to add additional content to the toolbar.
Examples
The following are a collection of examples that demonstrate more advanced and real world use of the v-toolbar component.
Contextual action bar
It is possible to update the appearance of a toolbar in response to changes in app state. In this example, the color and content of the toolbar changes in response to user selections in the v-select.
Flexible and card toolbar
In this example we offset our card onto the extended content area of a toolbar using the extended prop.
Floating with search
A floating toolbar is turned into an inline element that only takes up as much space as needed. This is particularly useful when placing toolbars over content.
Tooltips and Speed Dial
Toolbar elements can include menus (like Speed Dial) and tooltips to help users understand the action intent when buttons show only icons to keep interface minimalistic.