Fundamentos
VTag
`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.
<script setup lang="ts">
import { VTag } 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 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
<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
<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
<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
<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
<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
<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
<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
<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
<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
| Prop | Tipo | Default | Descrição |
|---|---|---|---|
size | VTagSize | "md" | — |
variant | VTagVariant | "default" | — |
interactive | boolean | null | null | Action tag: native button. Omit for auto — true unless `removable`. |
selected | boolean | — | — |
disabled | boolean | false | — |
removable | boolean | false | — |
leaving | boolean | false | — |
ariaLabel | string | — | — |
removeLabel | string | — | — |
dataTestId | string | — | — |
removeTestId | string | — | — |
Events
| Evento | Payload | Descrição |
|---|---|---|
@click | event: MouseEvent | — |
@remove | event: MouseEvent | — |
Slots
| Slot | Props do slot |
|---|---|
#icon | — |
#default | — |
Fonte: src/components/primitives/VTag/VTag.vue · tipos: src/components/primitives/VTag/VTag.types.ts