Ações

VButton

Componente17 exemplos13 propsA2UI · Button

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."

Importação
<script setup lang="ts">
import { VButton } 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 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
vue
<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
vue
<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
vue
<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
vue
<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
vue
<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
vue
<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
vue
<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
vue
<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
vue
<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
vue
<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
vue
<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
vue
<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
vue
<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
vue
<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
vue
<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
vue
<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
vue
<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

TriggerPropertyDurationEasing
Appearopacity/transform100msease-out
Hoverbackground/box-shadow100msease-out
Presstransform scale(.98)80msease-out
Loadingspinner rotate200mslinear
Focusoutline/box-shadow100msease-out

Respeitar prefers-reduced-motion.

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

Props

PropTipoDefaultDescrição
disabledbooleanfalse—
loadingbooleanfalse—
sizeVButtonSize"md"—
shapeVButtonShape—`pill` is the fully rounded action used in dashboard headers.
variantVButtonVariant"primary"—
intentVButtonIntent—Só afeta `variant="primary"`. Default `neutral`.
typeVButtonType"button"Native button behavior. Defaults to button to avoid accidental form submits.
ariaLabelstring——
motionVMotionLevelV_MOTION_DEFAULT ("expressive")—
microInteractionVButtonMicroInteraction"default"Expressive micro-interaction pattern (Fuse, Hold, Pulse Heart).
undoWindownumber—Fuse Button: undo window in ms after action.
holdDurationnumber—Hold Button: ms to hold before confirm.
favoriteCountnumber—Pulse Heart: displayed count.

Events

EventoPayloadDescrição
@clickevent: MouseEvent—
@undo——
@confirmed——

Slots

SlotProps do slot
#icon—
#default—
#undo-label—
#icon-end—

Fonte: src/components/form/VButton/VButton.vue · tipos: src/components/form/VButton/VButton.types.ts