Dados e tabelas
VFilterBar
Conjunto de controles inline para buscar, filtrar e refinar data views: ajuda a estreitar conteúdo rapidamente com interface limpa, consistente e flexível. (Design) valores: Flexible (search, selects, date ranges, chips…), Composable (mix-and-match p/ qualquer caso), Clean & Consistent. (Visual) valores: Discoverable (filtros comuns fáceis de achar/entender), Flexible, Fast (estreita resultados em segundos).
<script setup lang="ts">
import { VFilterBar } from 'vueui-nova-kit'
</script>Uso
<script setup lang="ts">
import { VFilterBar } from 'vueui-nova-kit'
</script>
<template>
<VFilterBar title="Project Tasks" resultsCount=243 totalCount=1284 activeCount=3 />
</template>Playground
Os controles abaixo são gerados a partir das props declaradas em VFilterBar.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 { VFilterBar } from 'vueui-nova-kit'
const chips = [
{ id: 'design', label: 'Design' },
{ id: 'priority', label: 'High Priority' },
{ id: 'owner', label: 'Alex Chen' },
]
const selects = [
{
id: 'status',
label: 'Status',
value: 'all',
options: [
{ label: 'All', value: 'all' },
{ label: 'Active', value: 'active' },
],
},
{
id: 'assignee',
label: 'Assignee',
value: 'all',
options: [
{ label: 'All', value: 'all' },
{ label: 'Alex Chen', value: 'alex' },
],
},
]
</script>
<template>
<VFilterBar
title="Project Tasks"
:chips="chips"
:selects="selects"
:results-count="243"
:total-count="1284"
:active-count="3"
date-range="Jan 1 2026 – Jan 31 2026"
variant="advanced" />
</template>Hero
Variação Hero. Props: title="Project Tasks", resultsCount=243, totalCount=1284, activeCount=3, variant="advanced".
Ver código
<script setup lang="ts">
import { VFilterBar } from 'vueui-nova-kit'
const chips = [
{ id: 'design', label: 'Design' },
{ id: 'priority', label: 'High Priority' },
{ id: 'owner', label: 'Alex Chen' },
]
const selects = [
{
id: 'status',
label: 'Status',
value: 'all',
options: [
{ label: 'All', value: 'all' },
{ label: 'Active', value: 'active' },
],
},
{
id: 'assignee',
label: 'Assignee',
value: 'all',
options: [
{ label: 'All', value: 'all' },
{ label: 'Alex Chen', value: 'alex' },
],
},
]
</script>
<template>
<VFilterBar
title="Project Tasks"
:chips="chips"
:selects="selects"
:results-count="243"
:total-count="1284"
:active-count="3"
date-range="Jan 1 2026 – Jan 31 2026"
variant="advanced" />
</template>Variants
Variação Variantes.
Ver código
<script setup lang="ts">
import { VFilterBar } from 'vueui-nova-kit'
const chips = [
{
id: 'design',
label: 'Design'
},
{
id: 'priority',
label: 'High Priority'
},
{
id: 'owner',
label: 'Alex Chen'
}
]
const selects = [
{
id: 'status',
label: 'Status',
value: 'all',
options: [
{
label: 'All',
value: 'all'
},
{
label: 'Active',
value: 'active'
}
]
},
{
id: 'assignee',
label: 'Assignee',
value: 'all',
options: [
{
label: 'All',
value: 'all'
},
{
label: 'Alex Chen',
value: 'alex'
}
]
}
]
</script>
<template>
<div style="display:grid;gap:24px">
<VFilterBar title="Basic" variant="basic" :selects="selects" :results-count="1482" />
<VFilterBar variant="chips" :chips="chips" :results-count="243" :total-count="1284" />
<VFilterBar variant="advanced" title="Advanced" :selects="selects" :chips="chips" :results-count="1482" />
<VFilterBar variant="sticky" sticky :results-count="243" :active-count="2" />
</div>
</template>Sizes
Variação Tamanhos.
Ver código
<script setup lang="ts">
import { VFilterBar } from 'vueui-nova-kit'
const selects = [
{
id: 'status',
label: 'Status',
value: 'all',
options: [
{
label: 'All',
value: 'all'
},
{
label: 'Active',
value: 'active'
}
]
},
{
id: 'assignee',
label: 'Assignee',
value: 'all',
options: [
{
label: 'All',
value: 'all'
},
{
label: 'Alex Chen',
value: 'alex'
}
]
}
]
</script>
<template>
<div style="display:grid;gap:24px">
<VFilterBar size="sm" :selects="selects" :results-count="243" />
<VFilterBar size="md" :selects="selects" :results-count="243" />
<VFilterBar size="lg" :selects="selects" :results-count="243" />
</div>
</template>States
Variação Estados.
Ver código
<script setup lang="ts">
import { VFilterBar } from 'vueui-nova-kit'
const selects = [
{
id: 'status',
label: 'Status',
value: 'all',
options: [
{
label: 'All',
value: 'all'
},
{
label: 'Active',
value: 'active'
}
]
},
{
id: 'assignee',
label: 'Assignee',
value: 'all',
options: [
{
label: 'All',
value: 'all'
},
{
label: 'Alex Chen',
value: 'alex'
}
]
}
]
</script>
<template>
<div style="display:grid;gap:24px">
<VFilterBar :selects="selects" :results-count="243" />
<VFilterBar loading :selects="selects" :results-count="243" />
<VFilterBar disabled :selects="selects" :results-count="243" />
<VFilterBar variant="chips" :chips="[{ id: 'active', label: 'Active', dot: true, severity: 'success' }]" :results-count="1482" />
</div>
</template>Filters And Shortcut
Variação Filters e Shortcut. Props: searchShortcut=true.
Ver código
<script setup lang="ts">
import { VFilterBar } from 'vueui-nova-kit'
const chips = [
{ id: 'design', label: 'Design' },
{ id: 'priority', label: 'High Priority' },
{ id: 'owner', label: 'Alex Chen' },
]
const selects = [
{
id: 'status',
label: 'Status',
value: 'all',
options: [
{ label: 'All', value: 'all' },
{ label: 'Active', value: 'active' },
],
},
{
id: 'assignee',
label: 'Assignee',
value: 'all',
options: [
{ label: 'All', value: 'all' },
{ label: 'Alex Chen', value: 'alex' },
],
},
]
const filters = { status: 'open' }
</script>
<template>
<VFilterBar
title="Project Tasks"
:chips="chips"
:selects="selects"
:results-count="243"
:total-count="1284"
:active-count="3"
date-range="Jan 1 2026 – Jan 31 2026"
variant="advanced"
:filters="filters" />
</template>Acessibilidade
- Labels claros e descritivos; ordem lógica de Tab; indicadores de foco visíveis; anúncios de filtros ativos/mudanças ao screen reader; cor não é o único indicador (chips + texto; dot + label); atalhos de teclado (Esc p/ limpar; ⌘K p/ buscar); roles/atributos ARIA adequados; alto contraste e estados acessíveis; (Visual) funciona em light e dark mode.
Props
| Prop | Tipo | Default | Descrição |
|---|---|---|---|
search | string | — | — |
filters | Record<string, string> | — | — |
dateRange | string | — | — |
chips | VFilterChip[] | [] | — |
selects | VFilterSelect[] | [] | — |
resultsCount | number | — | — |
totalCount | number | — | — |
activeCount | number | — | — |
size | VFilterBarSize | "md" | — |
variant | VFilterBarVariant | "basic" | — |
sticky | boolean | false | — |
loading | boolean | false | — |
disabled | boolean | false | — |
searchShortcut | boolean | true | — |
title | string | — | — |
dataTestId | string | — | — |
Events
| Evento | Payload | Descrição |
|---|---|---|
@update:search | string | — |
@update:filters | Record<string, string> | — |
@update:dateRange | string | — |
@update:chips | import('./VFilterBar.types').VFilterChip[] | — |
@change | — | — |
@clear | — | — |
@chip-remove | string | — |
Slots
Sem slots.
Fonte: src/components/table/VFilterBar/VFilterBar.vue · tipos: src/components/table/VFilterBar/VFilterBar.types.ts