Ações
VButton
Disparador de ação versátil para ações primárias, secundárias e contextuais. É o controle de ação fundamental do sistema: confirma formulários ("Save changes"), cria recursos ("Create project"), cancela fluxos ("Cancel"), abre menus contextuais ("…") e sinaliza processamento (loading). Card lateral da doc resume a diretriz de uso: "Buttons help users take action and make progress. Keep labels clear and concise."
<script setup lang="ts">
import { VButton } 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 VButton.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 { VButton } from 'vueui-nova-kit'
const args = {
size: 'md',
variant: 'primary'
}
const label = 'Primary'
</script>
<template>
<VButton v-bind="args">{{ label }}</VButton>
</template>Primary
Variação Primária. Props: variant="primary".
Ver código
<script setup lang="ts">
import { VButton } from 'vueui-nova-kit'
const args = {
size: 'md',
variant: 'primary'
}
const label = 'Primary'
</script>
<template>
<VButton v-bind="args">{{ label }}</VButton>
</template>Secondary
Variação Secundária. Props: variant="secondary".
Ver código
<script setup lang="ts">
import { VButton } from 'vueui-nova-kit'
const args = {
size: 'md',
variant: 'secondary'
}
const label = 'Secondary'
</script>
<template>
<VButton v-bind="args">{{ label }}</VButton>
</template>Ghost
Variação Ghost. Props: variant="ghost".
Ver código
<script setup lang="ts">
import { VButton } from 'vueui-nova-kit'
const args = {
size: 'md',
variant: 'ghost'
}
const label = 'Ghost'
</script>
<template>
<VButton v-bind="args">{{ label }}</VButton>
</template>Outline
Variação Contorno. Props: variant="outline".
Ver código
<script setup lang="ts">
import { VButton } from 'vueui-nova-kit'
const args = {
size: 'md',
variant: 'outline'
}
const label = 'Outline'
</script>
<template>
<VButton v-bind="args">{{ label }}</VButton>
</template>Pill
Variação Pill. Slots usados: #icon.
Ver código
<script setup lang="ts">
import { VButton, VIcon } from 'vueui-nova-kit'
const arrowLeftIcon = {
width: 24,
height: 24,
body: '<path fill=\'none\' stroke=\'currentColor\' stroke-linecap=\'round\' stroke-linejoin=\'round\' stroke-width=\'2\' d=\'M19 12H5.94129M11.8771 5L5.17385 11.5875C4.94205 11.8153 4.94205 12.1847 5.17385 12.4125L11.8771 19\'/>'
}
const arrowRightIcon = {
width: 24,
height: 24,
body: '<path fill=\'none\' stroke=\'currentColor\' stroke-linecap=\'round\' stroke-linejoin=\'round\' stroke-width=\'2\' d=\'M5 12H18.0587M12.1229 5L18.8261 11.5875C19.058 11.8153 19.058 12.1847 18.8261 12.4125L12.1229 19\'/>'
}
</script>
<template>
<div style="display:flex;gap:12px;align-items:center;flex-wrap:wrap;">
<VButton variant="outline" shape="pill">
<template #icon><VIcon :icon="arrowLeftIcon" size="sm" /></template>
Back to trace
</VButton>
<VButton variant="primary" shape="pill">
<template #icon><VIcon :icon="arrowRightIcon" size="sm" /></template>
Compare with failed run
</VButton>
</div>
</template>Destructive
Variação Destrutiva. Props: variant="destructive".
Ver código
<script setup lang="ts">
import { VButton } from 'vueui-nova-kit'
const args = {
size: 'md',
variant: 'destructive'
}
const label = 'Destructive'
</script>
<template>
<VButton v-bind="args">{{ label }}</VButton>
</template>Icon
Variação Ícone. Props: variant="icon", ariaLabel="Favorite". Slots usados: #icon.
Ver código
<script setup lang="ts">
import { VButton } from 'vueui-nova-kit'
const args = {
size: 'md',
variant: 'icon',
ariaLabel: 'Favorite'
}
</script>
<template>
<VButton v-bind="args"><template #icon>♥</template></VButton>
</template>Loading Variant
Variação Carregando variante. Props: variant="loading".
Ver código
<script setup lang="ts">
import { VButton } from 'vueui-nova-kit'
const args = {
size: 'md',
variant: 'loading'
}
</script>
<template>
<VButton v-bind="args">Loading</VButton>
</template>Sizes
Variação Tamanhos.
Ver código
<script setup lang="ts">
import { VButton } from 'vueui-nova-kit'
</script>
<template>
<div style="display:flex;gap:12px;align-items:center"><VButton size="sm">Small</VButton><VButton size="md">Medium</VButton><VButton size="lg">Large</VButton></div>
</template>Icon Sizes
Ícone quadrado por tamanho: variant="icon" usa a altura do tamanho (sm 32 / md 40 / lg 48).
Ver código
<script setup lang="ts">
import { VButton } from 'vueui-nova-kit'
</script>
<template>
<div style="display:flex;gap:12px;align-items:center"><VButton variant="icon" size="sm" aria-label="Favorite">♥</VButton><VButton variant="icon" size="md" aria-label="Favorite">♥</VButton><VButton variant="icon" size="lg" aria-label="Favorite">♥</VButton></div>
</template>States
Variação Estados.
Ver código
<script setup lang="ts">
import { VButton } from 'vueui-nova-kit'
</script>
<template>
<div style="display:flex;gap:12px;align-items:center;flex-wrap:wrap"><VButton>Default</VButton><VButton disabled>Disabled</VButton><VButton loading>Loading</VButton></div>
</template>Disabled
Variação Desabilitado. Props: disabled=true.
Ver código
<script setup lang="ts">
import { VButton } from 'vueui-nova-kit'
const args = {
size: 'md',
variant: 'primary',
disabled: true
}
const label = 'Primary'
</script>
<template>
<VButton v-bind="args">{{ label }}</VButton>
</template>Loading
Variação Carregando. Props: loading=true.
Ver código
<script setup lang="ts">
import { VButton } from 'vueui-nova-kit'
const args = {
size: 'md',
variant: 'primary',
loading: true
}
</script>
<template>
<VButton v-bind="args">Loading</VButton>
</template>Inverse
Variação Inversa. Props: variant="inverse".
Ver código
<script setup lang="ts">
import { VButton } from 'vueui-nova-kit'
const args = {
size: 'md',
variant: 'inverse'
}
const label = 'Ask AI'
</script>
<template>
<VButton v-bind="args">{{ label }}</VButton>
</template>Inverse With Icon
Variação Inversa com ícone.
Ver código
<script setup lang="ts">
import { VButton, VIcon } from 'vueui-nova-kit'
const arrowRightIcon = {
width: 24,
height: 24,
body: '<path fill=\'none\' stroke=\'currentColor\' stroke-linecap=\'round\' stroke-linejoin=\'round\' stroke-width=\'2\' d=\'M5 12H18.0587M12.1229 5L18.8261 11.5875C19.058 11.8153 19.058 12.1847 18.8261 12.4125L12.1229 19\'/>'
}
</script>
<template>
<VButton variant="inverse" shape="pill"><VIcon :icon="arrowRightIcon" size="sm" />Ask AI</VButton>
</template>Type Submit
Variação Type Submit. Props: type="submit", variant="primary".
Ver código
<script setup lang="ts">
import { VButton } from 'vueui-nova-kit'
const args = {
size: 'md',
variant: 'primary',
type: 'submit'
}
const label = 'Primary'
</script>
<template>
<VButton v-bind="args">{{ label }}</VButton>
</template>Acessibilidade
Semântica nativa <button>, foco visível com anel 0 0 0 3px rgba(99,102,241,.3), aria-label obrigatório em icon buttons, target mínimo 44×44px, teclado Enter/Space conforme padrão nativo.
Estados
Default · Hover · Focus-visible · Pressed/Active quando aplicável · Disabled · Loading quando aplicável.
Motion
| Trigger | Property | Duration | Easing |
|---|---|---|---|
| Appear | opacity/transform | 100ms | ease-out |
| Hover | background/box-shadow | 100ms | ease-out |
| Press | transform scale(.98) | 80ms | ease-out |
| Loading | spinner rotate | 200ms | linear |
| Focus | outline/box-shadow | 100ms | ease-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 | VButtonSize | "md" | — |
shape | VButtonShape | — | `pill` is the fully rounded action used in dashboard headers. |
variant | VButtonVariant | "primary" | — |
intent | VButtonIntent | — | Só afeta `variant="primary"`. Default `neutral`. |
type | VButtonType | "button" | Native button behavior. Defaults to button to avoid accidental form submits. |
ariaLabel | string | — | — |
motion | VMotionLevel | V_MOTION_DEFAULT ("expressive") | — |
microInteraction | VButtonMicroInteraction | "default" | Expressive micro-interaction pattern (Fuse, Hold, Pulse Heart). |
undoWindow | number | — | Fuse Button: undo window in ms after action. |
holdDuration | number | — | Hold Button: ms to hold before confirm. |
favoriteCount | number | — | Pulse Heart: displayed count. |
Events
| Evento | Payload | Descrição |
|---|---|---|
@click | event: MouseEvent | — |
@undo | — | — |
@confirmed | — | — |
Slots
| Slot | Props do slot |
|---|---|
#icon | — |
#default | — |
#undo-label | — |
#icon-end | — |
Fonte: src/components/form/VButton/VButton.vue · tipos: src/components/form/VButton/VButton.types.ts