0.0.2 • Published 8 years ago

angular-jq-querybuilder v0.0.2

Weekly downloads
24
License
ISC
Repository
github
Last release
8 years ago

angular-jqueryQueryBuilder

Angular directive for popular jquery plugin "jQuery query builder" (see https://github.com/mistic100/jQuery-QueryBuilder)

Dependencies

  • Angular >= 1.3.0
  • jQuery >= 1.10

Install

  • via bower: by running $ bower install 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 feauture). You have to handle it by yourself:

  • After rules object changes just call queryBuilder.setRules(newRules) method
  • After any other options change (for instance in filter) you need to reinstantiate builder (because there is no API in jquery). The simpliest way to do this is add nd-if into directive and switch it to fals eand 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