Ações

VToolbar

Componente6 exemplos5 props

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.

Importação
<script setup lang="ts">
import { VToolbar } from 'vueui-nova-kit'
</script>

Uso

Exemplo
<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
vue
<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
vue
<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
vue
<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
vue
<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
vue
<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
vue
<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-labels descritivos / 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

TriggerPropertyDurationEasing
Hoverbackground/transform120msout
Presstransform100msstandard
Focusoutline120msout

Respeitar prefers-reduced-motion.

Todas as transições respeitam prefers-reduced-motion e os tokens --v-duration-*.

Props

PropTipoDefaultDescrição
disabledbooleanfalse—
loadingbooleanfalse—
sizeVToolbarSize"md"—
variantVToolbarVariant"default"—
ariaLabelstring——

Events

Não emite eventos.

Slots

SlotProps do slot
#default—

Fonte: src/components/navigation/VToolbar/VToolbar.vue · tipos: src/components/navigation/VToolbar/VToolbar.types.ts