docs/app/pages/Components/Toolbar/Toolbar.vue
<example src="./examples/RegularToolbar.vue" />
<example src="./examples/ToolbarSizes.vue" />
<example src="./examples/ContentActions.vue" />
<template>
<page-container centered :title="$t('pages.toolbar.title')">
<div class="page-container-section">
<p>Toolbar actions appear above the view affected by their actions. They may constrain their width to accommodate material passing over them.</p>
</div>
<div class="page-container-section">
<h2 id="toolbars">Toolbars</h2>
<p>Toolbars adjusts its height dimensions based on the screen width to best fit the visible area on small devices. Try to resize your browser to see the difference:</p>
<code-example title="Regular Toolbars" :component="examples['regular-toolbar']" />
<api-item title="API - md-toolbar">
<p>The following options can be applied to all toolbars:</p>
<api-table :headings="api.regular.classes.headings" :props="api.regular.classes.props" slot="classes" />
<api-table :headings="api.regular.props.headings" :props="api.regular.props.props" slot="props" />
</api-item>
</div>
<div class="page-container-section">
<h2 id="different-sizes">Different Sizes</h2>
<code-example title="Sizes" :component="examples['toolbar-sizes']" />
</div>
<div class="page-container-section">
<h2 id="content-and-actions">Content and Actions</h2>
<p>As the Toolbars are mostly used to hold actions that affects the entire application, you can create rows or sections inside of it.</p>
<p>Although those rows works on every toolbar, they were created to separate contents for large toolbars. This element is represented by the <code>md-toolbar-row</code> class. A row can also have a <code>md-toolbar-offset</code> to add a little space on the left of it. This is commonly used inside the second row of an large toolbar.</p>
<p>The sections are used to split the content of the toolbar horizontally (or the row inside). You can apply them using two types of section: <code>md-toolbar-section-start</code> will be left-aligned and <code>md-toolbar-section-end</code> right-aligned.</p>
<code-example title="Rows, Title and Icons" :component="examples['content-actions']" />
<api-item title="Elements">
<p>The following classes creates parts of a toolbar:</p>
<api-table :headings="api.elements.classes.headings" :props="api.elements.classes.props" slot="classes" />
</api-item>
</div>
</page-container>
</template>
<script>
import examples from 'docs-mixins/docsExample'
export default {
name: 'DocToolbar',
mixins: [examples],
data: () => ({
api: {
regular: {
props: {
headings: ['Name', 'Description', 'Default'],
props: [
{
name: 'md-elevation',
type: 'String|Number',
description: 'Sets the toolbar shadow elevation',
defaults: '4'
}
]
},
classes: {
headings: ['Name', 'Description'],
props: [
{
name: 'md-transparent',
description: 'Makes the Toolbar background transparent'
},
{
name: 'md-dense',
description: 'Creates a small sized toolbar'
},
{
name: 'md-medium',
description: 'Creates a medium sized toolbar'
},
{
name: 'md-large',
description: 'Creates a large sized toolbar'
}
]
}
},
elements: {
classes: {
headings: ['Name', 'Description'],
props: [
{
name: 'md-toolbar-row',
description: 'Creates a toolbar row, commonly used on large toolbars'
},
{
name: 'md-toolbar-offset',
description: 'Adds an left offset to any toolbar row. Only works in md-toolbar-row'
},
{
name: 'md-toolbar-section-start',
description: 'Creates a section on the left of a toolbar or toolbar row. Commonly used to hold the application menu button and the title'
},
{
name: 'md-toolbar-section-end',
description: 'Creates a section on the right of a toolbar or toolbar row. Commonly used to hold the main action of a toolbar, such as overflow buttons'
},
{
name: 'md-title',
description: 'Will create the toolbar title. Works inside or outside a toolbar row'
}
]
}
}
}
})
}
</script>