Ações
VToolbar
Barra de ações compacta para fluxos de produtividade — agrupa ícones, divisórias, spacer e ação primária (Save) conforme o pôster VueUI Nova.
<script setup lang="ts">
import { VToolbar } from 'vueui-nova-kit'
</script>Uso
<script setup lang="ts">
</script>
<template>
</template>Playground
Os controles abaixo são gerados a partir das props declaradas em VToolbar.types.ts; o código acompanha cada mudança.
Exemplos
Variantes, tamanhos e estados, extraídos das stories da biblioteca.
Default
Variação Padrão. Estado padrão do componente; use a aba Controls para experimentar as props ao vivo.
Ver código
<script setup lang="ts">
import { VToolbar, VToolbarGroup, VToolbarButton, VToolbarDivider, VToolbarSpacer } from 'vueui-nova-kit'
const args = {
size: 'md',
variant: 'default',
ariaLabel: 'Document actions'
}
const overflowMenu = [
{
value: 'share',
label: 'Share',
icon: 'share'
},
{
value: 'download',
label: 'Download',
icon: 'download'
},
{
value: 'duplicate',
label: 'Duplicate',
icon: 'duplicate'
},
{
value: 'move-to',
label: 'Move to…',
icon: 'move-to'
}
]
</script>
<template>
<VToolbar v-bind="args">
<VToolbarGroup aria-label="File actions">
<VToolbarButton icon="plus" aria-label="New" />
<VToolbarButton icon="folder" aria-label="Open" />
<VToolbarButton icon="delete" aria-label="Delete" />
</VToolbarGroup>
<VToolbarDivider />
<VToolbarButton icon="undo" aria-label="Undo" />
<VToolbarButton icon="redo" aria-label="Redo" />
<VToolbarSpacer />
<VToolbarButton variant="primary" icon="save" label="Save" />
<VToolbarButton icon="more-h" aria-label="More actions" :menu="overflowMenu" />
</VToolbar>
</template>Variants
Variação Variantes.
Ver código
<script setup lang="ts">
import { VToolbar, VToolbarGroup, VToolbarButton, VToolbarDivider, VToolbarSpacer } from 'vueui-nova-kit'
const overflowMenu = [
{
value: 'share',
label: 'Share',
icon: 'share'
},
{
value: 'download',
label: 'Download',
icon: 'download'
},
{
value: 'duplicate',
label: 'Duplicate',
icon: 'duplicate'
},
{
value: 'move-to',
label: 'Move to…',
icon: 'move-to'
}
]
</script>
<template>
<div style="display:grid;gap:16px;">
<VToolbar data-test-id="docs-toolbar-variant-default" aria-label="Default toolbar">
<VToolbarGroup><VToolbarButton icon="plus" aria-label="New" /><VToolbarButton icon="folder" aria-label="Open" /></VToolbarGroup>
<VToolbarDivider />
<VToolbarButton icon="undo" aria-label="Undo" />
<VToolbarSpacer />
<VToolbarButton variant="primary" icon="save" label="Save" />
</VToolbar>
<VToolbar variant="compact" data-test-id="docs-toolbar-variant-compact" aria-label="Compact toolbar">
<VToolbarButton icon="bold" variant="toggle" aria-label="Bold" />
<VToolbarButton icon="italic" variant="toggle" aria-label="Italic" />
<VToolbarButton icon="link" aria-label="Link" />
</VToolbar>
<VToolbar variant="floating" data-test-id="docs-toolbar-variant-floating" aria-label="Floating toolbar">
<VToolbarButton icon="link" aria-label="Link" />
<VToolbarButton icon="image" variant="toggle" active aria-label="Image" />
<VToolbarButton icon="duplicate" aria-label="Duplicate" />
</VToolbar>
<VToolbar variant="editor" data-test-id="docs-toolbar-variant-editor" aria-label="Editor toolbar">
<VToolbarButton icon="bold" variant="toggle" aria-label="Bold" />
<VToolbarButton icon="italic" variant="toggle" aria-label="Italic" />
<VToolbarButton icon="underline" variant="toggle" aria-label="Underline" />
<VToolbarDivider />
<VToolbarButton icon="list" aria-label="List" />
</VToolbar>
</div>
</template>Sizes
Variação Tamanhos.
Ver código
<script setup lang="ts">
import { VToolbar, VToolbarButton, VToolbarSpacer } from 'vueui-nova-kit'
</script>
<template>
<div style="display:grid;gap:16px;">
<VToolbar size="sm" aria-label="Small toolbar"><VToolbarButton icon="save" aria-label="Save" /><VToolbarSpacer /><VToolbarButton variant="primary" icon="save" label="Save" /></VToolbar>
<VToolbar size="md" aria-label="Medium toolbar"><VToolbarButton icon="save" aria-label="Save" /><VToolbarSpacer /><VToolbarButton variant="primary" icon="save" label="Save" /></VToolbar>
<VToolbar size="lg" aria-label="Large toolbar"><VToolbarButton icon="save" aria-label="Save" /><VToolbarSpacer /><VToolbarButton variant="primary" icon="save" label="Save" /></VToolbar>
</div>
</template>Segmented
Variação Segmented. Props: variant="segmented", ariaLabel="Canvas tools".
Ver código
<script setup lang="ts">
import { VToolbar, VToolbarGroup, VToolbarButton, VToolbarDivider } from 'vueui-nova-kit'
const args = {
size: 'md',
variant: 'segmented',
ariaLabel: 'Canvas tools'
}
</script>
<template>
<div style="padding:32px;background:var(--v-color-neutral-100);border-radius:16px;">
<VToolbar v-bind="args">
<VToolbarGroup aria-label="Pointer tools">
<VToolbarButton icon="select" variant="toggle" active aria-label="Select" />
<VToolbarButton icon="pan" variant="toggle" aria-label="Pan" />
<VToolbarButton icon="zoom" variant="toggle" aria-label="Zoom" />
</VToolbarGroup>
<VToolbarDivider />
<VToolbarGroup aria-label="History">
<VToolbarButton icon="undo" aria-label="Undo" />
<VToolbarButton icon="redo" aria-label="Redo" />
</VToolbarGroup>
<VToolbarDivider />
<VToolbarGroup aria-label="Insert">
<VToolbarButton icon="plus" aria-label="Add node" />
<VToolbarButton icon="scan" aria-label="Frame selection" />
</VToolbarGroup>
</VToolbar>
</div>
</template>Disabled
Variação Desabilitado. Props: disabled=true.
Ver código
<script setup lang="ts">
import { VToolbar } from 'vueui-nova-kit'
</script>
<template>
<VToolbar aria-label="Document actions" disabled />
</template>Loading
Variação Carregando. Props: loading=true.
Ver código
<script setup lang="ts">
import { VToolbar } from 'vueui-nova-kit'
</script>
<template>
<VToolbar aria-label="Document actions" loading />
</template>Acessibilidade
- Icon buttons têm
aria-labelsdescritivos / nomes acessíveis. - Navegação por teclado (Tab, Arrow keys; Nav: + Enter, Space).
- Indicadores de foco visíveis; grupos/divisórias anunciados adequadamente; funciona com screen readers (roles + labels; Nav: layouts horizontal e vertical, responsivo e contextual).
- Contraste suficiente; suporta ações icon-only e icon+label; segue WAI-ARIA.
Estados
Default · Hover (fade + slide-up 120ms) · Focus-visible · Pressed (scale 0.98, 100ms) · Active/toggle · Disabled · Loading no container.
Motion
| Trigger | Property | Duration | Easing |
|---|---|---|---|
| Hover | background/transform | 120ms | out |
| Press | transform | 100ms | standard |
| Focus | outline | 120ms | out |
Respeitar prefers-reduced-motion.
Todas as transições respeitam prefers-reduced-motion e os tokens --v-duration-*.
Props
| Prop | Tipo | Default | Descrição |
|---|---|---|---|
disabled | boolean | false | — |
loading | boolean | false | — |
size | VToolbarSize | "md" | — |
variant | VToolbarVariant | "default" | — |
ariaLabel | string | — | — |
Events
Não emite eventos.
Slots
| Slot | Props do slot |
|---|---|
#default | — |
Fonte: src/components/navigation/VToolbar/VToolbar.vue · tipos: src/components/navigation/VToolbar/VToolbar.types.ts