angular-jqueryQueryBuilder
Angular directive for popular jquery plugin "jQuery query builder" (see https://github.com/mistic100/jQuery-QueryBuilder)
Examples
Eample of usage: https://laplasianin.github.io/angular-jqueryQueryBuilder/examples/usage/.
You can find source code under the 'docs' folder
Dependencies
- Angular >= 1.3.0 (only Angular 1 is supported)
- jQuery >= 1.10
Install
- via bower: by running
$ bower install angular-jq-querybuilder
from your terminal - via npm: by running
$ npm install -g angular-jq-querybuilder
from your terminal
Usage
Use folowing directive:
<query-builder options="options" builder="qb"></query-builder>
Attributes
options
Required attribute, plain js object. The same object as you use to initialize jQueryQueryBuilder with filters, rules and other fields:
$('#builder').queryBuilder({
filters: [ ... ]
});
builder
Not required, plain js object. After builder initialization is completed will be populated by property .builder which will contain builder object
Enhancements
Additional events
- QueryBuilderValueChanged. Event fires after any changes in builder values has happened (value is changed, rule/group is added/deleted, operator is changed, group condition is changed)
Notes
Please note that 2-way binding is not implemented so changes in 'options' attribute don't lead to builder update. It was done this way because of performance impact and some problem with circular updates (but may be will be implemented in future). You have to handle it by yourself:
- After rules object changes just call queryBuilder.setRules(newRules) method
- After any other options changes (for instance in filter) you need to reinstantiate builder (because there is no API in jquery). The simpliest way to do this is add ng-if into directive, switch it to false and then back to true:
<query-builder ng-if="builderVisible" options="options" builder="qb"></query-builder>
reinitializeFilter = function() {
scope.builderVisible = false
$timeout(function() {
return $scope.builderVisible = true;
}, 50);
}
And vice versa: rules object is not updated after it's updated from UI. You have to manually collect new rules by invoking .getRules()
method