Skip to content

Repository files navigation

query-kit

Vue 3 query builder and filter UI components, plus a schema-driven data table for displaying the results. Build complex nested filter and query conditions, then let users browse, sort and paginate the matching data collection, with the actual querying delegated to your own server.

Try the live playground →

query-kit screenshot

Features

  • Query / filter builder: visual editor for nested AND/OR groups, conditions, operators, scopes and relationship conditions.
  • Data collection / table: display results with pagination or infinite scroll, sortable columns, and an editable fields (columns) selector.
  • Schema-driven: entity, enum and request schemas drive the available properties, operators and inputs.
  • Server-side: the builder produces a serializable filter that you send to your backend through a configurable requester.
  • Customizable: custom input components, field renderers, icons, CSS classes and operators.
  • Internationalized: built-in locales with runtime language switching.
  • Typed: ships TypeScript declarations.

Installation

npm i @query-kit/vue @query-kit/themes

Quick start

import { createApp } from 'vue';
import { plugin } from '@query-kit/vue';
import '@query-kit/themes/default';

createApp(App).use(plugin, {
  entitySchemaLoader,
  requester,
  icons: 'default',
});

Provide your own entitySchemaLoader (loads an entity's schema) and requester (runs the query on your backend), then drop the component in:

<QkitSearch entity="user" v-model:filter="filter" v-model:fields="fields" />

Documentation

Full documentation, schema format and configuration options: https://comhon-project.github.io/query-kit/

License

MIT

About

Vue 3 query builder and filter UI components plus a schema-driven, sortable and paginated data table. Build complex nested AND/OR filters (conditions, operators, scopes, relationships), then let users browse and paginate results. Querying is delegated to your own backend. TypeScript, i18n, infinite scroll.

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Used by

Contributors

Languages