Dados e tabelas

VFilterBar

Componente6 exemplos16 props

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

Importação
<script setup lang="ts">
import { VFilterBar } from 'vueui-nova-kit'
</script>

Uso

Exemplo
<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
vue
<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
vue
<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
vue
<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
vue
<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
vue
<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
vue
<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

PropTipoDefaultDescrição
searchstring——
filtersRecord<string, string>——
dateRangestring——
chipsVFilterChip[][]—
selectsVFilterSelect[][]—
resultsCountnumber——
totalCountnumber——
activeCountnumber——
sizeVFilterBarSize"md"—
variantVFilterBarVariant"basic"—
stickybooleanfalse—
loadingbooleanfalse—
disabledbooleanfalse—
searchShortcutbooleantrue—
titlestring——
dataTestIdstring——

Events

EventoPayloadDescrição
@update:searchstring—
@update:filtersRecord<string, string>—
@update:dateRangestring—
@update:chipsimport('./VFilterBar.types').VFilterChip[]—
@change——
@clear——
@chip-removestring—

Slots

Sem slots.

Fonte: src/components/table/VFilterBar/VFilterBar.vue · tipos: src/components/table/VFilterBar/VFilterBar.types.ts