Fundamentos

VTag

Componente9 exemplos11 propsA2UI · Tag

`VTag` é o chip de **ação** (e de token acionável). Use para disparar uma ação compacta, filtrar, ou representar um atributo que o usuário pode remover.

Importação
<script setup lang="ts">
import { VTag } 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 VTag.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 { VTag } from 'vueui-nova-kit'

const args = {
  size: 'md',
  variant: 'default'
}
</script>

<template>
  <VTag v-bind="args">Filter</VTag>
</template>

Action

Variação Action. Slots usados: #icon.

Ver código
vue
<script setup lang="ts">
import { VTag, VIcon } from 'vueui-nova-kit'

const V_TAG_PLUS_ICON = {
  width: 24,
  height: 24,
  body: '<path fill=\'none\' stroke=\'currentColor\' stroke-linecap=\'round\' stroke-linejoin=\'round\' stroke-width=\'2\' d=\'M5 12H19M11.995 19.005V5.005\'/>'
}
</script>

<template>
  <VTag>
    <template #icon><VIcon :icon="V_TAG_PLUS_ICON" size="sm" /></template>
    Add Goals
  </VTag>
</template>

Variants

Variação Variantes. Slots usados: #icon.

Ver código
vue
<script setup lang="ts">
import { VTag, VIcon } from 'vueui-nova-kit'

const V_TAG_PLUS_ICON = {
  width: 24,
  height: 24,
  body: '<path fill=\'none\' stroke=\'currentColor\' stroke-linecap=\'round\' stroke-linejoin=\'round\' stroke-width=\'2\' d=\'M5 12H19M11.995 19.005V5.005\'/>'
}
</script>

<template>
  <div style="display:flex;align-items:center;gap:12px;flex-wrap:wrap">
    <VTag variant="default">
      <template #icon><VIcon :icon="V_TAG_PLUS_ICON" size="sm" /></template>
      Add Goals
    </VTag>
    <VTag variant="outline">Filter</VTag>
    <VTag variant="overlay" :interactive="false">Product</VTag>
    <VTag variant="soft" removable>Design</VTag>
  </div>
</template>

Sizes

Variação Tamanhos.

Ver código
vue
<script setup lang="ts">
import { VTag } from 'vueui-nova-kit'
</script>

<template>
  <div style="display:flex;align-items:center;gap:12px">
    <VTag size="sm">Small</VTag>
    <VTag size="md">Medium</VTag>
    <VTag size="lg">Large</VTag>
  </div>
</template>

Long Label

Variação Texto longo. O rótulo é truncado e a forma continua em pílula.

Ver código
vue
<script setup lang="ts">
import { VTag } from 'vueui-nova-kit'
</script>

<template>
  <div style="max-width:220px"><VTag removable variant="soft">Quarterly revenue goals for the enterprise segment</VTag></div>
</template>

Removable

Variação Removable.

Ver código
vue
<script setup lang="ts">
import { VTag } from 'vueui-nova-kit'
</script>

<template>
  <VTag removable variant="soft">Design</VTag>
</template>

Overlay

Variação Overlay.

Ver código
vue
<script setup lang="ts">
import { VTag } from 'vueui-nova-kit'
</script>

<template>
  <VTag variant="overlay" :interactive="false">Product</VTag>
</template>

Selected

Variação Selected. Props: selected=true, interactive=true.

Ver código
vue
<script setup lang="ts">
import { VTag } from 'vueui-nova-kit'

const args = {
  size: 'md',
  variant: 'default',
  selected: true,
  interactive: true
}
</script>

<template>
  <VTag v-bind="args">Selected</VTag>
</template>

Tag vs Badge

Variação Vs badge. Slots usados: #icon.

Ver código
vue
<script setup lang="ts">
import { VTag, VIcon, VBadge } from 'vueui-nova-kit'

const V_TAG_PLUS_ICON = {
  width: 24,
  height: 24,
  body: '<path fill=\'none\' stroke=\'currentColor\' stroke-linecap=\'round\' stroke-linejoin=\'round\' stroke-width=\'2\' d=\'M5 12H19M11.995 19.005V5.005\'/>'
}
</script>

<template>
  <div style="display:grid;gap:16px">
    <div>
      <div style="font-size:12px;color:var(--v-color-text-muted);margin-bottom:8px">Tag — ação / token</div>
      <div style="display:flex;gap:8px;flex-wrap:wrap;align-items:center">
        <VTag>
          <template #icon><VIcon :icon="V_TAG_PLUS_ICON" size="sm" /></template>
          Add Goals
        </VTag>
        <VTag variant="overlay" :interactive="false">Product</VTag>
        <VTag variant="soft" removable>Design</VTag>
      </div>
    </div>
    <div>
      <div style="font-size:12px;color:var(--v-color-text-muted);margin-bottom:8px">Badge — status / contagem</div>
      <div style="display:flex;gap:8px;flex-wrap:wrap;align-items:center">
        <VBadge variant="success" size="sm" icon="check">Ready</VBadge>
        <VBadge variant="success" size="sm">Completed</VBadge>
        <VBadge :count="12" />
        <VBadge variant="primary" icon="crown">Pro</VBadge>
      </div>
    </div>
  </div>
</template>

Props

PropTipoDefaultDescrição
sizeVTagSize"md"—
variantVTagVariant"default"—
interactiveboolean | nullnullAction tag: native button. Omit for auto — true unless `removable`.
selectedboolean——
disabledbooleanfalse—
removablebooleanfalse—
leavingbooleanfalse—
ariaLabelstring——
removeLabelstring——
dataTestIdstring——
removeTestIdstring——

Events

EventoPayloadDescrição
@clickevent: MouseEvent—
@removeevent: MouseEvent—

Slots

SlotProps do slot
#icon—
#default—

Fonte: src/components/primitives/VTag/VTag.vue · tipos: src/components/primitives/VTag/VTag.types.ts