README.md

jQuery QueryBuilder

jQuery plugin offering an simple interface to create complex queries.

Documentation

http://querybuilder.js.org

Dependencies

• jQuery >= 1.10
• Bootstrap >= 3.1 (CSS only)
• jQuery.extendext
• doT.js >= 1.0.3
• MomentJS (optional, for Date/Time validation)
• Other Bootstrap/jQuery plugins used by plugins

($.extendext and doT.js are directly included in the standalone file)

Browser support

• Internet Explorer >= 9
• All other recent browsers

Build

Prerequisites

• NodeJS + NPM: apt-get install nodejs-legacy npm
• Ruby Dev: apt-get install ruby-dev
• Grunt CLI: npm install -g grunt-cli
• Bower: npm install -g bower
• SASS: gem install sass

Run

Install Node and Bower dependencies npm install & bower install then run grunt in the root directory to generate production files inside dist.

Options

You can choose which plugins to include with --plugins :

# include "sql-support" and "mongodb-support" plugins
grunt --plugins=sql-support,mongodb-support

# disable all plugins
grunt --plugins=false

All plugins are included by default.

You can also include language files with --languages :

# include French & Italian translation
grunt --languages=fr,it

Other commands

• grunt test to run jshint/jscs/scsslint and the QUnit test suite.
• grunt list_modules to get the list of available plugins and languages.
• grunt describe_triggers to get the list of all triggers.
• grunt describe_errors to get the list of all fatal errors.
• grunt watch to automatically build the library when modifying the source files.

Inspiration

• Knockout Query Builder
• jui_filter_rules