- + + + + + + + + + + - - - - - - - - - + + // set filters + $('.set-filters').on('click', function() { + $(this).prop('disabled', true); + bootstrap.Tooltip.getInstance($(this)).hide(); + + // add a new filter after 'state' + $('#builder').queryBuilder('addFilter', + { + id: 'new_one', + label: 'New filter', + type: 'string' + }, + 'state' + ); + + // remove filter 'coord' + $('#builder').queryBuilder('removeFilter', + ['coord', 'state', 'bson'], + true + ); + // also available : 'setFilters' + }); + diff --git a/examples/screenshot.png b/examples/screenshot.png new file mode 100644 index 00000000..df0136c8 Binary files /dev/null and b/examples/screenshot.png differ diff --git a/package.json b/package.json index a638dda6..ed1b750a 100644 --- a/package.json +++ b/package.json @@ -1,27 +1,40 @@ { "name": "jQuery-QueryBuilder", - "version": "2.0.0", + "version": "3.0.0", "author": { "name": "Damien \"Mistic\" Sorel", "email": "contact@git.strangeplanet.fr", - "url": "http://www.strangeplanet.fr" + "url": "https://www.strangeplanet.fr" }, "description": "jQuery plugin for user friendly query/filter creator", + "main": "dist/js/query-builder.js", + "files": [ + "dist/", + "src/" + ], + "dependencies": { + "bootstrap": "^5.3.0", + "@popperjs/core": "^2.11.8", + "bootstrap-icons": "^1.11.3", + "jquery": "^3.5.1", + "jquery-extendext": "^1.0.0", + "moment": "^2.29.1", + "sql-parser-mistic": "^1.2.3" + }, "devDependencies": { - "grunt": "~0.4.5", - "grunt-contrib-qunit": "~0.5.0", - "grunt-contrib-uglify": "~0.8.0", - "grunt-contrib-cssmin": "~0.12.0", - "grunt-contrib-copy": "~0.8.0", - "grunt-contrib-concat": "~0.5.0", - "grunt-contrib-jshint": "~0.11.0", - "grunt-contrib-watch": "~0.6.0", - "grunt-contrib-sass": "~0.9.0", - "grunt-qunit-blanket-lcov": "~0.3.1", - "grunt-string-replace": "~1.0.0", - "grunt-coveralls": "~1.0.0", - "grunt-wrap": "~0.3.0", - "deepmerge": "~0.2.7" + "alive-server": "^1.3.0", + "awesome-bootstrap-checkbox": "^0.3.7", + "bootbox": "^6.0.0", + "bootstrap-slider": "^10.0.0", + "chosenjs": "^1.4.3", + "concurrently": "^8.2.0", + "deepmerge": "^2.1.0", + "foodoc": "^0.0.9", + "glob": "^10.3.1", + "interactjs": "^1.3.3", + "nodemon": "^2.0.22", + "sass": "^1.63.6", + "@selectize/selectize": "^0.15.2" }, "keywords": [ "jquery", @@ -30,7 +43,7 @@ "filter" ], "license": "MIT", - "homepage": "https://github.com/mistic100/jQuery-QueryBuilder", + "homepage": "https://querybuilder.js.org", "repository": { "type": "git", "url": "git://github.com/mistic100/jQuery-QueryBuilder.git" @@ -39,6 +52,9 @@ "url": "https://github.com/mistic100/jQuery-QueryBuilder/issues" }, "scripts": { - "test": "grunt test" + "build": "node ./build/dist.mjs", + "watch:build": "nodemon --watch src -e js,scss,json ./build/dist.mjs --dev", + "watch:serve": "node ./build/liveserver.mjs", + "serve": "concurrently \"npm:watch:build\" \"npm:watch:serve\"" } } diff --git a/src/.wrapper.js b/src/.wrapper.js index 6cd22a93..2b326090 100644 --- a/src/.wrapper.js +++ b/src/.wrapper.js @@ -1,6 +1,9 @@ (function(root, factory) { - if (typeof define === 'function' && define.amd) { - define(['jquery', 'jQuery.extendext'], factory); + if (typeof define == 'function' && define.amd) { + define(['jquery', 'jquery-extendext'], factory); + } + else if (typeof module === 'object' && module.exports) { + module.exports = factory(require('jquery'), require('jquery-extendext')); } else { factory(root.jQuery); @@ -10,4 +13,6 @@ @@js -})); \ No newline at end of file +return QueryBuilder; + +})); diff --git a/src/core.js b/src/core.js index 88b4002c..bcb7c912 100644 --- a/src/core.js +++ b/src/core.js @@ -1,62 +1,19 @@ /** - * Init the builder + * Final initialisation of the builder + * @param {object} [rules] + * @fires QueryBuilder.afterInit + * @private */ -QueryBuilder.prototype.init = function($el, options) { - $el[0].queryBuilder = this; - this.$el = $el; - - // PROPERTIES - this.settings = $.extendext(true, 'replace', {}, QueryBuilder.DEFAULTS, options); - this.model = new Model(); - this.status = { - group_id: 0, - rule_id: 0, - generated_id: false, - has_optgroup: false, - id: null - }; - - // "allow_groups" can be boolean or int - if (this.settings.allow_groups === false) { - this.settings.allow_groups = 0; - } - else if (this.settings.allow_groups === true) { - this.settings.allow_groups = -1; - } - - // SETTINGS SHORTCUTS - this.filters = this.settings.filters; - this.lang = this.settings.lang; - this.icons = this.settings.icons; - this.operators = this.settings.operators; - this.template = this.settings.template; - this.plugins = this.settings.plugins; - - if (this.template.group === null) { - this.template.group = this.getGroupTemplate; - } - if (this.template.rule === null) { - this.template.rule = this.getRuleTemplate; - } - - // ensure we have a container id - if (!this.$el.attr('id')) { - this.$el.attr('id', 'qb_'+Math.floor(Math.random()*99999)); - this.status.generated_id = true; - } - this.status.id = this.$el.attr('id'); - - // INIT - this.$el.addClass('query-builder form-inline'); - - this.checkFilters(); - this.bindEvents(); - this.initPlugins(); - +QueryBuilder.prototype.init = function(rules) { + /** + * When the initilization is done, just before creating the root group + * @event afterInit + * @memberof QueryBuilder + */ this.trigger('afterInit'); - if (options.rules) { - this.setRules(options.rules); + if (rules) { + this.setRules(rules); delete this.settings.rules; } else { @@ -66,21 +23,23 @@ QueryBuilder.prototype.init = function($el, options) { /** * Checks the configuration of each filter + * @param {QueryBuilder.Filter[]} filters + * @returns {QueryBuilder.Filter[]} + * @throws ConfigError */ -QueryBuilder.prototype.checkFilters = function() { - var definedFilters = [], - that = this; +QueryBuilder.prototype.checkFilters = function(filters) { + var definedFilters = []; - if (!this.filters || this.filters.length === 0) { - error('Missing filters list'); + if (!filters || filters.length === 0) { + Utils.error('Config', 'Missing filters list'); } - this.filters.forEach(function(filter, i) { + filters.forEach(function(filter, i) { if (!filter.id) { - error('Missing filter {0} id', i); + Utils.error('Config', 'Missing filter {0} id', i); } if (definedFilters.indexOf(filter.id) != -1) { - error('Filter "{0}" already defined', filter.id); + Utils.error('Config', 'Filter "{0}" already defined', filter.id); } definedFilters.push(filter.id); @@ -88,14 +47,22 @@ QueryBuilder.prototype.checkFilters = function() { filter.type = 'string'; } else if (!QueryBuilder.types[filter.type]) { - error('Invalid type "{0}"', filter.type); + Utils.error('Config', 'Invalid type "{0}"', filter.type); } if (!filter.input) { - filter.input = 'text'; + filter.input = QueryBuilder.types[filter.type] === 'number' ? 'number' : 'text'; } else if (typeof filter.input != 'function' && QueryBuilder.inputs.indexOf(filter.input) == -1) { - error('Invalid input "{0}"', filter.input); + Utils.error('Config', 'Invalid input "{0}"', filter.input); + } + + if (filter.operators) { + filter.operators.forEach(function(operator) { + if (typeof operator != 'string') { + Utils.error('Config', 'Filter operators must be global operators types (string)'); + } + }); } if (!filter.field) { @@ -109,97 +76,191 @@ QueryBuilder.prototype.checkFilters = function() { filter.optgroup = null; } else { - that.status.has_optgroup = true; + this.status.has_optgroup = true; + + // register optgroup if needed + if (!this.settings.optgroups[filter.optgroup]) { + this.settings.optgroups[filter.optgroup] = filter.optgroup; + } } switch (filter.input) { - case 'radio': case 'checkbox': + case 'radio': + case 'checkbox': if (!filter.values || filter.values.length < 1) { - error('Missing filter "{0}" values', filter.id); + Utils.error('Config', 'Missing filter "{0}" values', filter.id); + } + break; + + case 'select': + var cleanValues = []; + filter.has_optgroup = false; + + Utils.iterateOptions(filter.values, function(value, label, optgroup) { + cleanValues.push({ + value: value, + label: label, + optgroup: optgroup || null + }); + + if (optgroup) { + filter.has_optgroup = true; + + // register optgroup if needed + if (!this.settings.optgroups[optgroup]) { + this.settings.optgroups[optgroup] = optgroup; + } + } + }.bind(this)); + + if (filter.has_optgroup) { + filter.values = Utils.groupSort(cleanValues, 'optgroup'); + } + else { + filter.values = cleanValues; + } + + if (filter.placeholder) { + if (filter.placeholder_value === undefined) { + filter.placeholder_value = -1; + } + + filter.values.forEach(function(entry) { + if (entry.value == filter.placeholder_value) { + Utils.error('Config', 'Placeholder of filter "{0}" overlaps with one of its values', filter.id); + } + }); } break; } - }); + }, this); + + if (this.settings.sort_filters) { + if (typeof this.settings.sort_filters == 'function') { + filters.sort(this.settings.sort_filters); + } + else { + var self = this; + filters.sort(function(a, b) { + return self.translate(a.label).localeCompare(self.translate(b.label)); + }); + } + } - // group filters with same optgroup, preserving declaration order when possible if (this.status.has_optgroup) { - var optgroups = [], - filters = []; + filters = Utils.groupSort(filters, 'optgroup'); + } - this.filters.forEach(function(filter, i) { - var idx; + return filters; +}; - if (filter.optgroup) { - idx = optgroups.lastIndexOf(filter.optgroup); +/** + * Checks the configuration of each operator + * @param {QueryBuilder.Operator[]} operators + * @returns {QueryBuilder.Operator[]} + * @throws ConfigError + */ +QueryBuilder.prototype.checkOperators = function(operators) { + var definedOperators = []; - if (idx == -1) { - idx = optgroups.length; - } - else { - idx++; - } + operators.forEach(function(operator, i) { + if (typeof operator == 'string') { + if (!QueryBuilder.OPERATORS[operator]) { + Utils.error('Config', 'Unknown operator "{0}"', operator); } - else { - idx = optgroups.length; + + operators[i] = operator = $.extendext(true, 'replace', {}, QueryBuilder.OPERATORS[operator]); + } + else { + if (!operator.type) { + Utils.error('Config', 'Missing "type" for operator {0}', i); } - optgroups.splice(idx, 0, filter.optgroup); - filters.splice(idx, 0, filter); - }); + if (QueryBuilder.OPERATORS[operator.type]) { + operators[i] = operator = $.extendext(true, 'replace', {}, QueryBuilder.OPERATORS[operator.type], operator); + } - this.filters = filters; + if (operator.nb_inputs === undefined || operator.apply_to === undefined) { + Utils.error('Config', 'Missing "nb_inputs" and/or "apply_to" for operator "{0}"', operator.type); + } + } + + if (definedOperators.indexOf(operator.type) != -1) { + Utils.error('Config', 'Operator "{0}" already defined', operator.type); + } + definedOperators.push(operator.type); + + if (!operator.optgroup) { + operator.optgroup = null; + } + else { + this.status.has_operator_optgroup = true; + + // register optgroup if needed + if (!this.settings.optgroups[operator.optgroup]) { + this.settings.optgroups[operator.optgroup] = operator.optgroup; + } + } + }, this); + + if (this.status.has_operator_optgroup) { + operators = Utils.groupSort(operators, 'optgroup'); } + + return operators; }; /** - * Add all events listeners + * Adds all events listeners to the builder + * @private */ QueryBuilder.prototype.bindEvents = function() { - var that = this; + var self = this; + var Selectors = QueryBuilder.selectors; // group condition change - this.$el.on('change.queryBuilder', '.rules-group-header [name$=_cond]', function() { + this.$el.on('change.queryBuilder', Selectors.group_condition, function() { if ($(this).is(':checked')) { - var $group = $(this).closest('.rules-group-container'); - Model($group).condition = $(this).val(); + var $group = $(this).closest(Selectors.group_container); + self.getModel($group).condition = $(this).val(); } }); // rule filter change - this.$el.on('change.queryBuilder', '.rule-filter-container [name$=_filter]', function() { - var $rule = $(this).closest('.rule-container'); - Model($rule).filter = that.getFilterById($(this).val()); + this.$el.on('change.queryBuilder', Selectors.rule_filter, function() { + var $rule = $(this).closest(Selectors.rule_container); + self.getModel($rule).filter = self.getFilterById($(this).val()); }); // rule operator change - this.$el.on('change.queryBuilder', '.rule-operator-container [name$=_operator]', function() { - var $rule = $(this).closest('.rule-container'); - Model($rule).operator = that.getOperatorByType($(this).val()); + this.$el.on('change.queryBuilder', Selectors.rule_operator, function() { + var $rule = $(this).closest(Selectors.rule_container); + self.getModel($rule).operator = self.getOperatorByType($(this).val()); }); // add rule button - this.$el.on('click.queryBuilder', '[data-add=rule]', function() { - var $group = $(this).closest('.rules-group-container'); - that.addRule(Model($group)); + this.$el.on('click.queryBuilder', Selectors.add_rule, function() { + var $group = $(this).closest(Selectors.group_container); + self.addRule(self.getModel($group)); }); // delete rule button - this.$el.on('click.queryBuilder', '[data-delete=rule]', function() { - var $rule = $(this).closest('.rule-container'); - that.deleteRule(Model($rule)); + this.$el.on('click.queryBuilder', Selectors.delete_rule, function() { + var $rule = $(this).closest(Selectors.rule_container); + self.deleteRule(self.getModel($rule)); }); if (this.settings.allow_groups !== 0) { // add group button - this.$el.on('click.queryBuilder', '[data-add=group]', function() { - var $group = $(this).closest('.rules-group-container'); - that.addGroup(Model($group)); + this.$el.on('click.queryBuilder', Selectors.add_group, function() { + var $group = $(this).closest(Selectors.group_container); + self.addGroup(self.getModel($group)); }); // delete group button - this.$el.on('click.queryBuilder', '[data-delete=group]', function() { - var $group = $(this).closest('.rules-group-container'); - that.deleteGroup(Model($group)); + this.$el.on('click.queryBuilder', Selectors.delete_group, function() { + var $group = $(this).closest(Selectors.group_container); + self.deleteGroup(self.getModel($group)); }); } @@ -207,59 +268,95 @@ QueryBuilder.prototype.bindEvents = function() { this.model.on({ 'drop': function(e, node) { node.$el.remove(); + self.refreshGroupsConditions(); }, - 'add': function(e, node, index) { + 'add': function(e, parent, node, index) { + if (index === 0) { + node.$el.prependTo(parent.$el.find('>' + QueryBuilder.selectors.rules_list)); + } + else { + node.$el.insertAfter(parent.rules[index - 1].$el); + } + self.refreshGroupsConditions(); + }, + 'move': function(e, node, group, index) { node.$el.detach(); if (index === 0) { - node.$el.prependTo(node.parent.$el.find('>.rules-group-body>.rules-list')); + node.$el.prependTo(group.$el.find('>' + QueryBuilder.selectors.rules_list)); } else { - node.$el.insertAfter(node.parent.rules[index-1].$el); + node.$el.insertAfter(group.rules[index - 1].$el); } + self.refreshGroupsConditions(); }, 'update': function(e, node, field, value, oldValue) { - switch (field) { - case 'error': - that.displayError(node); - break; - - case 'condition': - that.updateGroupCondition(node); - break; - - case 'filter': - that.updateRuleFilter(node); - break; - - case 'operator': - that.updateRuleOperator(node, oldValue); - break; - - case 'flags': - that.applyRuleFlags(node); - break; + if (node instanceof Rule) { + switch (field) { + case 'error': + self.updateError(node); + break; + + case 'flags': + self.applyRuleFlags(node); + break; + + case 'filter': + self.updateRuleFilter(node, oldValue); + break; + + case 'operator': + self.updateRuleOperator(node, oldValue); + break; + + case 'value': + self.updateRuleValue(node, oldValue); + break; + } + } + else { + switch (field) { + case 'error': + self.updateError(node); + break; + + case 'flags': + self.applyGroupFlags(node); + break; + + case 'condition': + self.updateGroupCondition(node, oldValue); + break; + } } } }); }; /** - * Create the root group - * @param addRule {bool,optional} add a default empty rule - * @return group {Root} + * Creates the root group + * @param {boolean} [addRule=true] - adds a default empty rule + * @param {object} [data] - group custom data + * @param {object} [flags] - flags to apply to the group + * @returns {Group} root group + * @fires QueryBuilder.afterAddGroup */ -QueryBuilder.prototype.setRoot = function(addRule) { +QueryBuilder.prototype.setRoot = function(addRule, data, flags) { addRule = (addRule === undefined || addRule === true); - var group_id = this.nextGroupId(), - $group = $(this.template.group.call(this, group_id, 1)); + var group_id = this.nextGroupId(); + var $group = $($.parseHTML(this.getGroupTemplate(group_id, 1))); this.$el.append($group); this.model.root = new Group(null, $group); this.model.root.model = this.model; + + this.model.root.data = data; + this.model.root.flags = $.extend({}, this.settings.default_group_flags, flags); this.model.root.condition = this.settings.default_condition; + this.trigger('afterAddGroup', this.model.root); + if (addRule) { this.addRule(this.model.root); } @@ -268,28 +365,55 @@ QueryBuilder.prototype.setRoot = function(addRule) { }; /** - * Add a new group - * @param parent {Group} - * @param addRule {bool,optional} add a default empty rule - * @return group {Group} + * Adds a new group + * @param {Group} parent + * @param {boolean} [addRule=true] - adds a default empty rule + * @param {object} [data] - group custom data + * @param {object} [flags] - flags to apply to the group + * @returns {Group} + * @fires QueryBuilder.beforeAddGroup + * @fires QueryBuilder.afterAddGroup */ -QueryBuilder.prototype.addGroup = function(parent, addRule) { +QueryBuilder.prototype.addGroup = function(parent, addRule, data, flags) { addRule = (addRule === undefined || addRule === true); var level = parent.level + 1; + /** + * Just before adding a group, can be prevented. + * @event beforeAddGroup + * @memberof QueryBuilder + * @param {Group} parent + * @param {boolean} addRule - if an empty rule will be added in the group + * @param {int} level - nesting level of the group, 1 is the root group + */ var e = this.trigger('beforeAddGroup', parent, addRule, level); if (e.isDefaultPrevented()) { return null; } - var group_id = this.nextGroupId(), - $group = $(this.template.group.call(this, group_id, level)), - model = parent.addGroup($group); + var group_id = this.nextGroupId(); + var $group = $(this.getGroupTemplate(group_id, level)); + var model = parent.addGroup($group); + + model.data = data; + model.flags = $.extend({}, this.settings.default_group_flags, flags); + model.condition = this.settings.default_condition; + /** + * Just after adding a group + * @event afterAddGroup + * @memberof QueryBuilder + * @param {Group} group + */ this.trigger('afterAddGroup', model); - model.condition = this.settings.default_condition; + /** + * After any change in the rules + * @event rulesChanged + * @memberof QueryBuilder + */ + this.trigger('rulesChanged'); if (addRule) { this.addRule(model); @@ -299,15 +423,23 @@ QueryBuilder.prototype.addGroup = function(parent, addRule) { }; /** - * Tries to delete a group. The group is not deleted if at least one rule is no_delete. - * @param group {Group} - * @return {boolean} true if the group has been deleted + * Tries to delete a group. The group is not deleted if at least one rule is flagged `no_delete`. + * @param {Group} group + * @returns {boolean} if the group has been deleted + * @fires QueryBuilder.beforeDeleteGroup + * @fires QueryBuilder.afterDeleteGroup */ QueryBuilder.prototype.deleteGroup = function(group) { if (group.isRoot()) { return false; } + /** + * Just before deleting a group, can be prevented + * @event beforeDeleteGroup + * @memberof QueryBuilder + * @param {Group} parent + */ var e = this.trigger('beforeDeleteGroup', group); if (e.isDefaultPrevented()) { return false; @@ -316,63 +448,147 @@ QueryBuilder.prototype.deleteGroup = function(group) { var del = true; group.each('reverse', function(rule) { - del&= this.deleteRule(rule); + del &= this.deleteRule(rule); }, function(group) { - del&= this.deleteGroup(group); + del &= this.deleteGroup(group); }, this); if (del) { group.drop(); + + /** + * Just after deleting a group + * @event afterDeleteGroup + * @memberof QueryBuilder + */ this.trigger('afterDeleteGroup'); + + this.trigger('rulesChanged'); } return del; }; /** - * Changes the condition of a group - * @param group {Group} + * Performs actions when a group's condition changes + * @param {Group} group + * @param {object} previousCondition + * @fires QueryBuilder.afterUpdateGroupCondition + * @private */ -QueryBuilder.prototype.updateGroupCondition = function(group) { - group.$el.find('>.rules-group-header [name$=_cond]').each(function() { +QueryBuilder.prototype.updateGroupCondition = function(group, previousCondition) { + group.$el.find('>' + QueryBuilder.selectors.group_condition).each(function() { var $this = $(this); $this.prop('checked', $this.val() === group.condition); $this.parent().toggleClass('active', $this.val() === group.condition); }); + + /** + * After the group condition has been modified + * @event afterUpdateGroupCondition + * @memberof QueryBuilder + * @param {Group} group + * @param {object} previousCondition + */ + this.trigger('afterUpdateGroupCondition', group, previousCondition); + + this.trigger('rulesChanged'); }; /** - * Add a new rule - * @param parent {Group} - * @return rule {Rule} + * Updates the visibility of conditions based on number of rules inside each group + * @private */ -QueryBuilder.prototype.addRule = function(parent) { +QueryBuilder.prototype.refreshGroupsConditions = function() { + (function walk(group) { + if (!group.flags || (group.flags && !group.flags.condition_readonly)) { + group.$el.find('>' + QueryBuilder.selectors.group_condition).prop('disabled', group.rules.length <= 1) + .parent().toggleClass('disabled', group.rules.length <= 1); + } + + group.each(null, function(group) { + walk(group); + }, this); + }(this.model.root)); +}; + +/** + * Adds a new rule + * @param {Group} parent + * @param {object} [data] - rule custom data + * @param {object} [flags] - flags to apply to the rule + * @returns {Rule} + * @fires QueryBuilder.beforeAddRule + * @fires QueryBuilder.afterAddRule + * @fires QueryBuilder.changer:getDefaultFilter + */ +QueryBuilder.prototype.addRule = function(parent, data, flags) { + /** + * Just before adding a rule, can be prevented + * @event beforeAddRule + * @memberof QueryBuilder + * @param {Group} parent + */ var e = this.trigger('beforeAddRule', parent); if (e.isDefaultPrevented()) { return null; } - var rule_id = this.nextRuleId(), - $rule = $(this.template.rule.call(this, rule_id)), - model = parent.addRule($rule); + var rule_id = this.nextRuleId(); + var $rule = $($.parseHTML(this.getRuleTemplate(rule_id))); + var model = parent.addRule($rule); + + model.data = data; + model.flags = $.extend({}, this.settings.default_rule_flags, flags); + /** + * Just after adding a rule + * @event afterAddRule + * @memberof QueryBuilder + * @param {Rule} rule + */ this.trigger('afterAddRule', model); + this.trigger('rulesChanged'); + this.createRuleFilters(model); + if (this.settings.default_filter || !this.settings.display_empty_filter) { + /** + * Modifies the default filter for a rule + * @event changer:getDefaultFilter + * @memberof QueryBuilder + * @param {QueryBuilder.Filter} filter + * @param {Rule} rule + * @returns {QueryBuilder.Filter} + */ + model.filter = this.change('getDefaultFilter', + this.getFilterById(this.settings.default_filter || this.filters[0].id), + model + ); + } + return model; }; /** - * Delete a rule. - * @param rule {Rule} - * @return {boolean} true if the rule has been deleted + * Tries to delete a rule + * @param {Rule} rule + * @returns {boolean} if the rule has been deleted + * @fires QueryBuilder.beforeDeleteRule + * @fires QueryBuilder.afterDeleteRule */ QueryBuilder.prototype.deleteRule = function(rule) { if (rule.flags.no_delete) { return false; } + /** + * Just before deleting a rule, can be prevented + * @event beforeDeleteRule + * @memberof QueryBuilder + * @param {Rule} rule + */ var e = this.trigger('beforeDeleteRule', rule); if (e.isDefaultPrevented()) { return false; @@ -380,151 +596,311 @@ QueryBuilder.prototype.deleteRule = function(rule) { rule.drop(); + /** + * Just after deleting a rule + * @event afterDeleteRule + * @memberof QueryBuilder + */ this.trigger('afterDeleteRule'); + this.trigger('rulesChanged'); + return true; }; /** - * Create the filters for a rule - * @param rule {Rule} + * Creates the filters for a rule + * @param {Rule} rule + * @fires QueryBuilder.changer:getRuleFilters + * @fires QueryBuilder.afterCreateRuleFilters + * @private */ QueryBuilder.prototype.createRuleFilters = function(rule) { + /** + * Modifies the list a filters available for a rule + * @event changer:getRuleFilters + * @memberof QueryBuilder + * @param {QueryBuilder.Filter[]} filters + * @param {Rule} rule + * @returns {QueryBuilder.Filter[]} + */ var filters = this.change('getRuleFilters', this.filters, rule); + var $filterSelect = $($.parseHTML(this.getRuleFilterSelect(rule, filters))); - var $filterSelect = $(this.getRuleFilterSelect(rule, filters)); - - rule.$el.find('.rule-filter-container').append($filterSelect); + rule.$el.find(QueryBuilder.selectors.filter_container).html($filterSelect); + /** + * After creating the dropdown for filters + * @event afterCreateRuleFilters + * @memberof QueryBuilder + * @param {Rule} rule + */ this.trigger('afterCreateRuleFilters', rule); + + this.applyRuleFlags(rule); }; /** - * Create the operators for a rule and init the rule operator - * @param rule {Rule} + * Creates the operators for a rule and init the rule operator + * @param {Rule} rule + * @fires QueryBuilder.afterCreateRuleOperators + * @private */ -QueryBuilder.prototype.createRuleOperators = function(rule, triggerChangeOperator) { - var $operatorContainer = rule.$el.find('.rule-operator-container').empty(); +QueryBuilder.prototype.createRuleOperators = function(rule) { + var $operatorContainer = rule.$el.find(QueryBuilder.selectors.operator_container).empty(); if (!rule.filter) { return; } - var operators = this.getOperators(rule.filter), - $operatorSelect = $(this.getRuleOperatorSelect(rule, operators)); + var operators = this.getOperators(rule.filter); + var $operatorSelect = $($.parseHTML(this.getRuleOperatorSelect(rule, operators))); $operatorContainer.html($operatorSelect); - if (triggerChangeOperator !== false) { - rule.operator = operators[0]; + // set the operator without triggering update event + if (rule.filter.default_operator) { + rule.__.operator = this.getOperatorByType(rule.filter.default_operator); } else { rule.__.operator = operators[0]; } + rule.$el.find(QueryBuilder.selectors.rule_operator).val(rule.operator.type); + + /** + * After creating the dropdown for operators + * @event afterCreateRuleOperators + * @memberof QueryBuilder + * @param {Rule} rule + * @param {QueryBuilder.Operator[]} operators - allowed operators for this rule + */ this.trigger('afterCreateRuleOperators', rule, operators); + + this.applyRuleFlags(rule); }; /** - * Create the main input for a rule - * @param rule {Rule} + * Creates the main input for a rule + * @param {Rule} rule + * @fires QueryBuilder.afterCreateRuleInput + * @private */ QueryBuilder.prototype.createRuleInput = function(rule) { - var $valueContainer = rule.$el.find('.rule-value-container').empty(); + var $valueContainer = rule.$el.find(QueryBuilder.selectors.value_container).empty(); + + rule.__.value = undefined; - if (!rule.filter || rule.operator.nb_inputs === 0) { + if (!rule.filter || !rule.operator || rule.operator.nb_inputs === 0) { return; } - var $inputs = $(), - filter = rule.filter; + var self = this; + var $inputs = $(); + var filter = rule.filter; - for (var i=0; i< rule.operator.nb_inputs; i++) { + var $ruleInput = $($.parseHTML($.trim(this.getRuleInput(rule, i)))); if (i > 0) $valueContainer.append(this.settings.inputs_separator); $valueContainer.append($ruleInput); $inputs = $inputs.add($ruleInput); } - $valueContainer.show(); + $valueContainer.css('display', ''); + + $inputs.on('change ' + (filter.input_event || ''), function() { + if (!rule._updating_input) { + rule._updating_value = true; + rule.value = self.getRuleInputValue(rule); + rule._updating_value = false; + } + }); if (filter.plugin) { $inputs[filter.plugin](filter.plugin_config || {}); } + /** + * After creating the input for a rule and initializing optional plugin + * @event afterCreateRuleInput + * @memberof QueryBuilder + * @param {Rule} rule + */ this.trigger('afterCreateRuleInput', rule); if (filter.default_value !== undefined) { - this.setRuleValue(rule, filter.default_value); + rule.value = filter.default_value; + } + else { + rule._updating_value = true; + rule.value = self.getRuleInputValue(rule); + rule._updating_value = false; } + + this.applyRuleFlags(rule); }; /** - * Perform action when rule's filter is changed - * @param rule {Rule} + * Performs action when a rule's filter changes + * @param {Rule} rule + * @param {object} previousFilter + * @fires QueryBuilder.afterUpdateRuleFilter + * @private */ -QueryBuilder.prototype.updateRuleFilter = function(rule) { - this.createRuleOperators(rule, false); +QueryBuilder.prototype.updateRuleFilter = function(rule, previousFilter) { + this.createRuleOperators(rule); this.createRuleInput(rule); - rule.$el.find('.rule-filter-container [name$=_filter]').val(rule.filter ? rule.filter.id : '-1'); + rule.$el.find(QueryBuilder.selectors.rule_filter).val(rule.filter ? rule.filter.id : '-1'); + + // clear rule data if the filter changed + if (previousFilter && rule.filter && previousFilter.id !== rule.filter.id) { + rule.data = undefined; + } + + /** + * After the filter has been updated and the operators and input re-created + * @event afterUpdateRuleFilter + * @memberof QueryBuilder + * @param {Rule} rule + * @param {object} previousFilter + */ + this.trigger('afterUpdateRuleFilter', rule, previousFilter); - this.trigger('afterUpdateRuleFilter', rule); + this.trigger('rulesChanged'); }; /** - * Update main visibility when rule operator changes - * @param rule {Rule} - * @param previousOperator {object} + * Performs actions when a rule's operator changes + * @param {Rule} rule + * @param {object} previousOperator + * @fires QueryBuilder.afterUpdateRuleOperator + * @private */ QueryBuilder.prototype.updateRuleOperator = function(rule, previousOperator) { - var $valueContainer = rule.$el.find('.rule-value-container'); + var $valueContainer = rule.$el.find(QueryBuilder.selectors.value_container); if (!rule.operator || rule.operator.nb_inputs === 0) { $valueContainer.hide(); + + rule.__.value = undefined; } else { - $valueContainer.show(); + $valueContainer.css('display', ''); - if ($valueContainer.is(':empty') || rule.operator.nb_inputs !== previousOperator.nb_inputs) { + if ($valueContainer.is(':empty') || !previousOperator || + rule.operator.nb_inputs !== previousOperator.nb_inputs || + rule.operator.optgroup !== previousOperator.optgroup + ) { this.createRuleInput(rule); } } if (rule.operator) { - rule.$el.find('.rule-operator-container [name$=_operator]').val(rule.operator.type); + rule.$el.find(QueryBuilder.selectors.rule_operator).val(rule.operator.type); + + // refresh value if the format changed for this operator + rule.__.value = this.getRuleInputValue(rule); } - this.trigger('afterUpdateRuleOperator', rule); + /** + * After the operator has been updated and the input optionally re-created + * @event afterUpdateRuleOperator + * @memberof QueryBuilder + * @param {Rule} rule + * @param {object} previousOperator + */ + this.trigger('afterUpdateRuleOperator', rule, previousOperator); + + this.trigger('rulesChanged'); }; /** - * Change rules properties depending on flags. - * @param rule {Rule} - * @param readonly {boolean} + * Performs actions when rule's value changes + * @param {Rule} rule + * @param {object} previousValue + * @fires QueryBuilder.afterUpdateRuleValue + * @private */ -QueryBuilder.prototype.applyRuleFlags = function(rule, readonly) { +QueryBuilder.prototype.updateRuleValue = function(rule, previousValue) { + if (!rule._updating_value) { + this.setRuleInputValue(rule, rule.value); + } + + /** + * After the rule value has been modified + * @event afterUpdateRuleValue + * @memberof QueryBuilder + * @param {Rule} rule + * @param {*} previousValue + */ + this.trigger('afterUpdateRuleValue', rule, previousValue); + + this.trigger('rulesChanged'); +}; + +/** + * Changes a rule's properties depending on its flags + * @param {Rule} rule + * @fires QueryBuilder.afterApplyRuleFlags + * @private + */ +QueryBuilder.prototype.applyRuleFlags = function(rule) { var flags = rule.flags; + var Selectors = QueryBuilder.selectors; + + rule.$el.find(Selectors.rule_filter).prop('disabled', flags.filter_readonly); + rule.$el.find(Selectors.rule_operator).prop('disabled', flags.operator_readonly); + rule.$el.find(Selectors.rule_value).prop('disabled', flags.value_readonly); - if (flags.filter_readonly) { - rule.$el.find('[name$=_filter]').prop('disabled', true); + if (flags.no_delete) { + rule.$el.find(Selectors.delete_rule).remove(); } - if (flags.operator_readonly) { - rule.$el.find('[name$=_operator]').prop('disabled', true); + + /** + * After rule's flags has been applied + * @event afterApplyRuleFlags + * @memberof QueryBuilder + * @param {Rule} rule + */ + this.trigger('afterApplyRuleFlags', rule); +}; + +/** + * Changes group's properties depending on its flags + * @param {Group} group + * @fires QueryBuilder.afterApplyGroupFlags + * @private + */ +QueryBuilder.prototype.applyGroupFlags = function(group) { + var flags = group.flags; + var Selectors = QueryBuilder.selectors; + + group.$el.find('>' + Selectors.group_condition).prop('disabled', flags.condition_readonly) + .parent().toggleClass('readonly', flags.condition_readonly); + + if (flags.no_add_rule) { + group.$el.find(Selectors.add_rule).remove(); } - if (flags.value_readonly) { - rule.$el.find('[name*=_value_]').prop('disabled', true); + if (flags.no_add_group) { + group.$el.find(Selectors.add_group).remove(); } if (flags.no_delete) { - rule.$el.find('[data-delete=rule]').remove(); + group.$el.find(Selectors.delete_group).remove(); } - this.trigger('afterApplyRuleFlags', rule); + /** + * After group's flags has been applied + * @event afterApplyGroupFlags + * @memberof QueryBuilder + * @param {Group} group + */ + this.trigger('afterApplyGroupFlags', group); }; /** - * Clear all errors markers - * @param node {Node,optional} default is root Group + * Clears all errors markers + * @param {Node} [node] default is root Group */ QueryBuilder.prototype.clearErrors = function(node) { node = node || this.model.root; @@ -545,39 +921,61 @@ QueryBuilder.prototype.clearErrors = function(node) { }; /** - * Add/Remove class .has-error and update error title - * @param node {Node} + * Adds/Removes error on a Rule or Group + * @param {Node} node + * @fires QueryBuilder.changer:displayError + * @private */ -QueryBuilder.prototype.displayError = function(node) { +QueryBuilder.prototype.updateError = function(node) { if (this.settings.display_errors) { if (node.error === null) { node.$el.removeClass('has-error'); } else { - // translate the text without modifying event array - var error = $.extend([], node.error, [ - this.lang.errors[node.error[0]] || node.error[0] - ]); + var errorMessage = this.translate('errors', node.error[0]); + errorMessage = Utils.fmt(errorMessage, node.error.slice(1)); + + /** + * Modifies an error message before display + * @event changer:displayError + * @memberof QueryBuilder + * @param {string} errorMessage - the error message (translated and formatted) + * @param {array} error - the raw error array (error code and optional arguments) + * @param {Node} node + * @returns {string} + */ + errorMessage = this.change('displayError', errorMessage, node.error, node); node.$el.addClass('has-error') - .find('.error-container').eq(0).attr('title', fmt.apply(null, error)); + .find(QueryBuilder.selectors.error_container).eq(0) + .attr('title', errorMessage); } } }; /** - * Trigger a validation error event - * @param node {Node} - * @param error {array} - * @param value {mixed} + * Triggers a validation error event + * @param {Node} node + * @param {string|array} error + * @param {*} value + * @fires QueryBuilder.validationError + * @private */ QueryBuilder.prototype.triggerValidationError = function(node, error, value) { if (!$.isArray(error)) { error = [error]; } + /** + * Fired when a validation error occurred, can be prevented + * @event validationError + * @memberof QueryBuilder + * @param {Node} node + * @param {string} error + * @param {*} value + */ var e = this.trigger('validationError', node, error, value); if (!e.isDefaultPrevented()) { node.error = error; } -}; \ No newline at end of file +}; diff --git a/src/data.js b/src/data.js index a90aff0e..7f466940 100644 --- a/src/data.js +++ b/src/data.js @@ -1,193 +1,218 @@ -/*jshint loopfunc:true */ - /** - * Check if a value is correct for a filter - * @param rule {Rule} - * @param value {string|string[]|undefined} - * @return {array|true} + * Performs value validation + * @param {Rule} rule + * @param {string|string[]} value + * @returns {array|boolean} true or error array + * @fires QueryBuilder.changer:validateValue */ QueryBuilder.prototype.validateValue = function(rule, value) { - var validation = rule.filter.validation || {}, - result = true; + var validation = rule.filter.validation || {}; + var result = true; if (validation.callback) { result = validation.callback.call(this, value, rule); } else { - result = this.validateValueInternal(rule, value); + result = this._validateValue(rule, value); } + /** + * Modifies the result of the rule validation method + * @event changer:validateValue + * @memberof QueryBuilder + * @param {array|boolean} result - true or an error array + * @param {*} value + * @param {Rule} rule + * @returns {array|boolean} + */ return this.change('validateValue', result, value, rule); }; /** * Default validation function - * @param rule {Rule} - * @param value {string|string[]|undefined} - * @return {array|true} + * @param {Rule} rule + * @param {string|string[]} value + * @returns {array|boolean} true or error array + * @throws ConfigError + * @private */ -QueryBuilder.prototype.validateValueInternal = function(rule, value) { - var filter = rule.filter, - operator = rule.operator, - validation = filter.validation || {}, - result = true, - tmp; +QueryBuilder.prototype._validateValue = function(rule, value) { + var filter = rule.filter; + var operator = rule.operator; + var validation = filter.validation || {}; + var result = true; + var tmp, tempValue; if (rule.operator.nb_inputs === 1) { value = [value]; } - else { - value = value; - } - for (var i=0; i< operator.nb_inputs; i++) { + if (!operator.multiple && $.isArray(value[i]) && value[i].length > 1) { + result = ['operator_not_multiple', operator.type, this.translate('operators', operator.type)]; + break; + } switch (filter.input) { case 'radio': - if (value[i] === undefined) { - result = ['radio_empty']; + if (value[i] === undefined || value[i].length === 0) { + if (!validation.allow_empty_value) { + result = ['radio_empty']; + } break; } break; case 'checkbox': - if (value[i].length === 0) { - result = ['checkbox_empty']; - break; - } - else if (!operator.multiple && value[i].length > 1) { - result = ['operator_not_multiple', this.lang[operator.type] || operator.type]; + if (value[i] === undefined || value[i].length === 0) { + if (!validation.allow_empty_value) { + result = ['checkbox_empty']; + } break; } break; case 'select': - if (filter.multiple) { - if (value[i].length === 0) { - result = ['select_empty']; - break; - } - else if (!operator.multiple && value[i].length > 1) { - result = ['operator_not_multiple', this.lang[operator.type] || operator.type]; - break; - } - } - else { - if (value[i] === undefined) { + if (value[i] === undefined || value[i].length === 0 || (filter.placeholder && value[i] == filter.placeholder_value)) { + if (!validation.allow_empty_value) { result = ['select_empty']; - break; } + break; } break; default: - switch (QueryBuilder.types[filter.type]) { - case 'string': - if (value[i].length === 0) { - result = ['string_empty']; - break; - } - if (validation.min !== undefined) { - if (value[i].length < parseInt(validation.min)) { - result = ['string_exceed_min_length', validation.min]; + tempValue = $.isArray(value[i]) ? value[i] : [value[i]]; + + for (var j = 0; j < tempValue.length; j++) { + switch (QueryBuilder.types[filter.type]) { + case 'string': + if (tempValue[j] === undefined || tempValue[j].length === 0) { + if (!validation.allow_empty_value) { + result = ['string_empty']; + } break; } - } - if (validation.max !== undefined) { - if (value[i].length > parseInt(validation.max)) { - result = ['string_exceed_max_length', validation.max]; - break; + if (validation.min !== undefined) { + if (tempValue[j].length < parseInt(validation.min)) { + result = [this.getValidationMessage(validation, 'min', 'string_exceed_min_length'), validation.min]; + break; + } } - } - if (validation.format) { - if (typeof validation.format === 'string') { - validation.format = new RegExp(validation.format); + if (validation.max !== undefined) { + if (tempValue[j].length > parseInt(validation.max)) { + result = [this.getValidationMessage(validation, 'max', 'string_exceed_max_length'), validation.max]; + break; + } } - if (!validation.format.test(value[i])) { - result = ['string_invalid_format', validation.format]; - break; + if (validation.format) { + if (typeof validation.format == 'string') { + validation.format = new RegExp(validation.format); + } + if (!validation.format.test(tempValue[j])) { + result = [this.getValidationMessage(validation, 'format', 'string_invalid_format'), validation.format]; + break; + } } - } - break; - - case 'number': - if (isNaN(value[i])) { - result = ['number_nan']; break; - } - if (filter.type == 'integer') { - if (parseInt(value[i]) != value[i]) { - result = ['number_not_integer']; + + case 'number': + if (tempValue[j] === undefined || tempValue[j].length === 0) { + if (!validation.allow_empty_value) { + result = ['number_nan']; + } break; } - } - else { - if (parseFloat(value[i]) != value[i]) { - result = ['number_not_double']; + if (isNaN(tempValue[j])) { + result = ['number_nan']; break; } - } - if (validation.min !== undefined) { - if (value[i] < parseFloat(validation.min)) { - result = ['number_exceed_min', validation.min]; - break; + if (filter.type == 'integer') { + if (parseInt(tempValue[j]) != tempValue[j]) { + result = ['number_not_integer']; + break; + } } - } - if (validation.max !== undefined) { - if (value[i] > parseFloat(validation.max)) { - result = ['number_exceed_max', validation.max]; - break; + else { + if (parseFloat(tempValue[j]) != tempValue[j]) { + result = ['number_not_double']; + break; + } } - } - if (validation.step !== undefined) { - var v = value[i]/validation.step; - if (parseInt(v) != v) { - result = ['number_wrong_step', validation.step]; - break; + if (validation.min !== undefined) { + if (tempValue[j] < parseFloat(validation.min)) { + result = [this.getValidationMessage(validation, 'min', 'number_exceed_min'), validation.min]; + break; + } } - } - break; - - case 'datetime': - if (value[i].length === 0) { - result = ['datetime_empty']; - break; - } - - // we need MomentJS - if (validation.format) { - if (!('moment' in window)) { - error('MomentJS is required for Date/Time validation'); + if (validation.max !== undefined) { + if (tempValue[j] > parseFloat(validation.max)) { + result = [this.getValidationMessage(validation, 'max', 'number_exceed_max'), validation.max]; + break; + } + } + if (validation.step !== undefined && validation.step !== 'any') { + var v = (tempValue[j] / validation.step).toPrecision(14); + if (parseInt(v) != v) { + result = [this.getValidationMessage(validation, 'step', 'number_wrong_step'), validation.step]; + break; + } } + break; - var datetime = moment(value[i], validation.format); - if (!datetime.isValid()) { - result = ['datetime_invalid']; + case 'datetime': + if (tempValue[j] === undefined || tempValue[j].length === 0) { + if (!validation.allow_empty_value) { + result = ['datetime_empty']; + } break; } - else { - if (validation.min) { - if (datetime < moment(validation.min, validation.format)) { - result = ['datetime_exceed_min', validation.min]; - break; - } + + // we need MomentJS + if (validation.format) { + if (!('moment' in window)) { + Utils.error('MissingLibrary', 'MomentJS is required for Date/Time validation. Get it here http://momentjs.com'); + } + + var datetime = moment(tempValue[j], validation.format); + if (!datetime.isValid()) { + result = [this.getValidationMessage(validation, 'format', 'datetime_invalid'), validation.format]; + break; } - if (validation.max) { - if (datetime > moment(validation.max, validation.format)) { - result = ['datetime_exceed_max', validation.max]; - break; + else { + if (validation.min) { + if (datetime < moment(validation.min, validation.format)) { + result = [this.getValidationMessage(validation, 'min', 'datetime_exceed_min'), validation.min]; + break; + } + } + if (validation.max) { + if (datetime > moment(validation.max, validation.format)) { + result = [this.getValidationMessage(validation, 'max', 'datetime_exceed_max'), validation.max]; + break; + } } } } - } - break; - - case 'boolean': - tmp = value[i].trim().toLowerCase(); - if (tmp !== 'true' && tmp !== 'false' && tmp !== '1' && tmp !== '0' && value[i] !== 1 && value[i] !== 0) { - result = ['boolean_not_valid']; break; - } + + case 'boolean': + if (tempValue[j] === undefined || tempValue[j].length === 0) { + if (!validation.allow_empty_value) { + result = ['boolean_not_valid']; + } + break; + } + tmp = ('' + tempValue[j]).trim().toLowerCase(); + if (tmp !== 'true' && tmp !== 'false' && tmp !== '1' && tmp !== '0' && tempValue[j] !== 1 && tempValue[j] !== 0) { + result = ['boolean_not_valid']; + break; + } + } + + if (result !== true) { + break; + } } } @@ -196,12 +221,36 @@ QueryBuilder.prototype.validateValueInternal = function(rule, value) { } } + if ((rule.operator.type === 'between' || rule.operator.type === 'not_between') && value.length === 2) { + switch (QueryBuilder.types[filter.type]) { + case 'number': + if (value[0] > value[1]) { + result = ['number_between_invalid', value[0], value[1]]; + } + break; + + case 'datetime': + // we need MomentJS + if (validation.format) { + if (!('moment' in window)) { + Utils.error('MissingLibrary', 'MomentJS is required for Date/Time validation. Get it here http://momentjs.com'); + } + + if (moment(value[0], validation.format).isAfter(moment(value[1], validation.format))) { + result = ['datetime_between_invalid', value[0], value[1]]; + } + } + break; + } + } + return result; }; /** * Returns an incremented group ID - * @return {string} + * @returns {string} + * @private */ QueryBuilder.prototype.nextGroupId = function() { return this.status.id + '_group_' + (this.status.group_id++); @@ -209,7 +258,8 @@ QueryBuilder.prototype.nextGroupId = function() { /** * Returns an incremented rule ID - * @return {string} + * @returns {string} + * @private */ QueryBuilder.prototype.nextRuleId = function() { return this.status.id + '_rule_' + (this.status.rule_id++); @@ -217,17 +267,18 @@ QueryBuilder.prototype.nextRuleId = function() { /** * Returns the operators for a filter - * @param filter {string|object} (filter id name or filter object) - * @return {object[]} + * @param {string|object} filter - filter id or filter object + * @returns {object[]} + * @fires QueryBuilder.changer:getOperators */ QueryBuilder.prototype.getOperators = function(filter) { - if (typeof filter === 'string') { + if (typeof filter == 'string') { filter = this.getFilterById(filter); } var result = []; - for (var i=0, l=this.operators.length; i< l; i++) { // filter operators check if (filter.operators) { if (filter.operators.indexOf(this.operators[i].type) == -1) { @@ -249,133 +300,184 @@ QueryBuilder.prototype.getOperators = function(filter) { }); } + /** + * Modifies the operators available for a filter + * @event changer:getOperators + * @memberof QueryBuilder + * @param {QueryBuilder.Operator[]} operators + * @param {QueryBuilder.Filter} filter + * @returns {QueryBuilder.Operator[]} + */ return this.change('getOperators', result, filter); }; /** * Returns a particular filter by its id - * @param filterId {string} - * @return {object|null} + * @param {string} id + * @param {boolean} [doThrow=true] + * @returns {object|null} + * @throws UndefinedFilterError */ -QueryBuilder.prototype.getFilterById = function(id) { +QueryBuilder.prototype.getFilterById = function(id, doThrow) { if (id == '-1') { return null; } - for (var i=0, l=this.filters.length; i< l; i++) { if (this.filters[i].id == id) { return this.filters[i]; } } - error('Undefined filter "{0}"', id); + Utils.error(doThrow !== false, 'UndefinedFilter', 'Undefined filter "{0}"', id); + + return null; }; /** - * Return a particular operator by its type - * @param type {string} - * @return {object|null} + * Returns a particular operator by its type + * @param {string} type + * @param {boolean} [doThrow=true] + * @returns {object|null} + * @throws UndefinedOperatorError */ -QueryBuilder.prototype.getOperatorByType = function(type) { +QueryBuilder.prototype.getOperatorByType = function(type, doThrow) { if (type == '-1') { return null; } - for (var i=0, l=this.operators.length; i< l; i++) { if (this.operators[i].type == type) { return this.operators[i]; } } - error('Undefined operator "{0}"', type); + Utils.error(doThrow !== false, 'UndefinedOperator', 'Undefined operator "{0}"', type); + + return null; }; /** - * Returns rule value - * @param rule {Rule} - * @return {mixed} + * Returns rule's current input value + * @param {Rule} rule + * @returns {*} + * @fires QueryBuilder.changer:getRuleValue + * @private */ -QueryBuilder.prototype.getRuleValue = function(rule) { - var filter = rule.filter, - operator = rule.operator, - $value = rule.$el.find('.rule-value-container'), - value = [], tmp; +QueryBuilder.prototype.getRuleInputValue = function(rule) { + var filter = rule.filter; + var operator = rule.operator; + var value = []; - for (var i=0; i< operator.nb_inputs; i++) { + var name = Utils.escapeElementId(rule.id + '_value_' + i); + var tmp; - case 'checkbox': - tmp = []; - $value.find('[name='+ name +']:checked').each(function() { - tmp.push($(this).val()); - }); - value.push(tmp); - break; + switch (filter.input) { + case 'radio': + value.push($value.find('[name=' + name + ']:checked').val()); + break; - case 'select': - if (filter.multiple) { + case 'checkbox': tmp = []; - $value.find('[name='+ name +'] option:selected').each(function() { + $value.find('[name=' + name + ']:checked').each(function() { tmp.push($(this).val()); }); value.push(tmp); - } - else { - value.push($value.find('[name='+ name +'] option:selected').val()); - } - break; + break; - default: - value.push($value.find('[name='+ name +']').val()); + case 'select': + if (filter.multiple) { + tmp = []; + $value.find('[name=' + name + '] option:selected').each(function() { + tmp.push($(this).val()); + }); + value.push(tmp); + } + else { + value.push($value.find('[name=' + name + '] option:selected').val()); + } + break; + + default: + value.push($value.find('[name=' + name + ']').val()); + } } - } - if (operator.nb_inputs === 1) { - value = value[0]; - } + value = value.map(function(val) { + if (operator.multiple && filter.value_separator && typeof val == 'string') { + val = val.split(filter.value_separator); + } + + if ($.isArray(val)) { + return val.map(function(subval) { + return Utils.changeType(subval, filter.type); + }); + } + else { + return Utils.changeType(val, filter.type); + } + }); + + if (operator.nb_inputs === 1) { + value = value[0]; + } - if (filter.valueParser) { - value = filter.valueParser.call(this, rule, value); + // @deprecated + if (filter.valueParser) { + value = filter.valueParser.call(this, rule, value); + } } + /** + * Modifies the rule's value grabbed from the DOM + * @event changer:getRuleValue + * @memberof QueryBuilder + * @param {*} value + * @param {Rule} rule + * @returns {*} + */ return this.change('getRuleValue', value, rule); }; /** - * Sets the value of a rule. - * @param rule {Rule} - * @param value {mixed} + * Sets the value of a rule's input + * @param {Rule} rule + * @param {*} value + * @private */ -QueryBuilder.prototype.setRuleValue = function(rule, value) { - var filter = rule.filter, - operator = rule.operator; +QueryBuilder.prototype.setRuleInputValue = function(rule, value) { + var filter = rule.filter; + var operator = rule.operator; + + if (!filter || !operator) { + return; + } - this.trigger('beforeSetRuleValue', rule, value); + rule._updating_input = true; if (filter.valueSetter) { filter.valueSetter.call(this, rule, value); } else { - var $value = rule.$el.find('.rule-value-container'); + var $value = rule.$el.find(QueryBuilder.selectors.value_container); if (operator.nb_inputs == 1) { value = [value]; } - else { - value = value; - } - for (var i=0; i< operator.nb_inputs; i++) { + var name = Utils.escapeElementId(rule.id + '_value_' + i); switch (filter.input) { case 'radio': - $value.find('[name='+ name +'][value="'+ value[i] +'"]').prop('checked', true).trigger('change'); + $value.find('[name=' + name + '][value="' + value[i] + '"]').prop('checked', true).trigger('change'); break; case 'checkbox': @@ -383,24 +485,29 @@ QueryBuilder.prototype.setRuleValue = function(rule, value) { value[i] = [value[i]]; } value[i].forEach(function(value) { - $value.find('[name='+ name +'][value="'+ value +'"]').prop('checked', true).trigger('change'); + $value.find('[name=' + name + '][value="' + value + '"]').prop('checked', true).trigger('change'); }); break; default: - $value.find('[name='+ name +']').val(value[i]).trigger('change'); + if (operator.multiple && filter.value_separator && $.isArray(value[i])) { + value[i] = value[i].join(filter.value_separator); + } + $value.find('[name=' + name + ']').val(value[i]).trigger('change'); break; } } } - this.trigger('afterSetRuleValue', rule, value); + rule._updating_input = false; }; /** - * Clean rule flags. - * @param rule {object} - * @return {object} + * Parses rule flags + * @param {object} rule + * @returns {object} + * @fires QueryBuilder.changer:parseRuleFlags + * @private */ QueryBuilder.prototype.parseRuleFlags = function(rule) { var flags = $.extend({}, this.settings.default_rule_flags); @@ -415,8 +522,139 @@ QueryBuilder.prototype.parseRuleFlags = function(rule) { } if (rule.flags) { - $.extend(flags, rule.flags); + $.extend(flags, rule.flags); } + /** + * Modifies the consolidated rule's flags + * @event changer:parseRuleFlags + * @memberof QueryBuilder + * @param {object} flags + * @param {object} rule - not a Rule object + * @returns {object} + */ return this.change('parseRuleFlags', flags, rule); -}; \ No newline at end of file +}; + +/** + * Gets a copy of flags of a rule + * @param {object} flags + * @param {boolean} [all=false] - return all flags or only changes from default flags + * @returns {object} + * @private + */ +QueryBuilder.prototype.getRuleFlags = function(flags, all) { + if (all) { + return $.extend({}, flags); + } + else { + var ret = {}; + $.each(this.settings.default_rule_flags, function(key, value) { + if (flags[key] !== value) { + ret[key] = flags[key]; + } + }); + return ret; + } +}; + +/** + * Parses group flags + * @param {object} group + * @returns {object} + * @fires QueryBuilder.changer:parseGroupFlags + * @private + */ +QueryBuilder.prototype.parseGroupFlags = function(group) { + var flags = $.extend({}, this.settings.default_group_flags); + + if (group.readonly) { + $.extend(flags, { + condition_readonly: true, + no_add_rule: true, + no_add_group: true, + no_delete: true + }); + } + + if (group.flags) { + $.extend(flags, group.flags); + } + + /** + * Modifies the consolidated group's flags + * @event changer:parseGroupFlags + * @memberof QueryBuilder + * @param {object} flags + * @param {object} group - not a Group object + * @returns {object} + */ + return this.change('parseGroupFlags', flags, group); +}; + +/** + * Gets a copy of flags of a group + * @param {object} flags + * @param {boolean} [all=false] - return all flags or only changes from default flags + * @returns {object} + * @private + */ +QueryBuilder.prototype.getGroupFlags = function(flags, all) { + if (all) { + return $.extend({}, flags); + } + else { + var ret = {}; + $.each(this.settings.default_group_flags, function(key, value) { + if (flags[key] !== value) { + ret[key] = flags[key]; + } + }); + return ret; + } +}; + +/** + * Translate a label either by looking in the `lang` object or in itself if it's an object where keys are language codes + * @param {string} [category] + * @param {string|object} key + * @returns {string} + * @fires QueryBuilder.changer:translate + */ +QueryBuilder.prototype.translate = function(category, key) { + if (!key) { + key = category; + category = undefined; + } + + var translation; + if (typeof key === 'object') { + translation = key[this.settings.lang_code] || key['en']; + } + else { + translation = (category ? this.lang[category] : this.lang)[key] || key; + } + + /** + * Modifies the translated label + * @event changer:translate + * @memberof QueryBuilder + * @param {string} translation + * @param {string|object} key + * @param {string} [category] + * @returns {string} + */ + return this.change('translate', translation, key, category); +}; + +/** + * Returns a validation message + * @param {object} validation + * @param {string} type + * @param {string} def + * @returns {string} + * @private + */ +QueryBuilder.prototype.getValidationMessage = function(validation, type, def) { + return validation.messages && validation.messages[type] || def; +}; diff --git a/src/defaults.js b/src/defaults.js index e7778fbd..b63b1251 100644 --- a/src/defaults.js +++ b/src/defaults.js @@ -1,31 +1,132 @@ +/** + * Allowed types and their internal representation + * @type {object.} + * @readonly + * @private + */ QueryBuilder.types = { - 'string': 'string', - 'integer': 'number', - 'double': 'number', - 'date': 'datetime', - 'time': 'datetime', + 'string': 'string', + 'integer': 'number', + 'double': 'number', + 'date': 'datetime', + 'time': 'datetime', 'datetime': 'datetime', - 'boolean': 'boolean' + 'boolean': 'boolean' }; +/** + * Allowed inputs + * @type {string[]} + * @readonly + * @private + */ QueryBuilder.inputs = [ 'text', + 'number', 'textarea', 'radio', 'checkbox', 'select' ]; +/** + * Runtime modifiable options with `setOptions` method + * @type {string[]} + * @readonly + * @private + */ QueryBuilder.modifiable_options = [ 'display_errors', 'allow_groups', - 'allow_empty' + 'allow_empty', + 'default_condition', + 'default_filter' ]; +/** + * CSS selectors for common components + * @type {object.} + * @readonly + */ +QueryBuilder.selectors = { + group_container: '.rules-group-container', + rule_container: '.rule-container', + filter_container: '.rule-filter-container', + operator_container: '.rule-operator-container', + value_container: '.rule-value-container', + error_container: '.error-container', + condition_container: '.rules-group-header .group-conditions', + + rule_header: '.rule-header', + group_header: '.rules-group-header', + group_actions: '.group-actions', + rule_actions: '.rule-actions', + + rules_list: '.rules-group-body>.rules-list', + + group_condition: '.rules-group-header [name$=_cond]', + rule_filter: '.rule-filter-container [name$=_filter]', + rule_operator: '.rule-operator-container [name$=_operator]', + rule_value: '.rule-value-container [name*=_value_]', + + add_rule: '[data-add=rule]', + delete_rule: '[data-delete=rule]', + add_group: '[data-add=group]', + delete_group: '[data-delete=group]' +}; + +/** + * Template strings (see template.js) + * @type {object.} + * @readonly + */ +QueryBuilder.templates = {}; + +/** + * Localized strings (see i18n/) + * @type {object.} + * @readonly + */ +QueryBuilder.regional = {}; + +/** + * Default operators + * @type {object.} + * @readonly + */ +QueryBuilder.OPERATORS = { + equal: { type: 'equal', nb_inputs: 1, multiple: false, apply_to: ['string', 'number', 'datetime', 'boolean'] }, + not_equal: { type: 'not_equal', nb_inputs: 1, multiple: false, apply_to: ['string', 'number', 'datetime', 'boolean'] }, + in: { type: 'in', nb_inputs: 1, multiple: true, apply_to: ['string', 'number', 'datetime'] }, + not_in: { type: 'not_in', nb_inputs: 1, multiple: true, apply_to: ['string', 'number', 'datetime'] }, + less: { type: 'less', nb_inputs: 1, multiple: false, apply_to: ['number', 'datetime'] }, + less_or_equal: { type: 'less_or_equal', nb_inputs: 1, multiple: false, apply_to: ['number', 'datetime'] }, + greater: { type: 'greater', nb_inputs: 1, multiple: false, apply_to: ['number', 'datetime'] }, + greater_or_equal: { type: 'greater_or_equal', nb_inputs: 1, multiple: false, apply_to: ['number', 'datetime'] }, + between: { type: 'between', nb_inputs: 2, multiple: false, apply_to: ['number', 'datetime'] }, + not_between: { type: 'not_between', nb_inputs: 2, multiple: false, apply_to: ['number', 'datetime'] }, + begins_with: { type: 'begins_with', nb_inputs: 1, multiple: false, apply_to: ['string'] }, + not_begins_with: { type: 'not_begins_with', nb_inputs: 1, multiple: false, apply_to: ['string'] }, + contains: { type: 'contains', nb_inputs: 1, multiple: false, apply_to: ['string'] }, + not_contains: { type: 'not_contains', nb_inputs: 1, multiple: false, apply_to: ['string'] }, + ends_with: { type: 'ends_with', nb_inputs: 1, multiple: false, apply_to: ['string'] }, + not_ends_with: { type: 'not_ends_with', nb_inputs: 1, multiple: false, apply_to: ['string'] }, + is_empty: { type: 'is_empty', nb_inputs: 0, multiple: false, apply_to: ['string'] }, + is_not_empty: { type: 'is_not_empty', nb_inputs: 0, multiple: false, apply_to: ['string'] }, + is_null: { type: 'is_null', nb_inputs: 0, multiple: false, apply_to: ['string', 'number', 'datetime', 'boolean'] }, + is_not_null: { type: 'is_not_null', nb_inputs: 0, multiple: false, apply_to: ['string', 'number', 'datetime', 'boolean'] } +}; + +/** + * Default configuration + * @type {object} + * @readonly + */ QueryBuilder.DEFAULTS = { filters: [], plugins: [], + sort_filters: false, display_errors: true, allow_groups: -1, allow_empty: false, @@ -33,6 +134,9 @@ QueryBuilder.DEFAULTS = { default_condition: 'AND', inputs_separator: ' , ', select_placeholder: '------', + display_empty_filter: true, + default_filter: null, + optgroups: {}, default_rule_flags: { filter_readonly: false, @@ -41,96 +145,52 @@ QueryBuilder.DEFAULTS = { no_delete: false }, - template: { - group: null, - rule: null + default_group_flags: { + condition_readonly: false, + no_add_rule: false, + no_add_group: false, + no_delete: false }, - lang: { - "add_rule": 'Add rule', - "add_group": 'Add group', - "delete_rule": 'Delete', - "delete_group": 'Delete', - - "conditions": { - "AND": "AND", - "OR": "OR" - }, - - "operators": { - "equal": "equal", - "not_equal": "not equal", - "in": "in", - "not_in": "not in", - "less": "less", - "less_or_equal": "less or equal", - "greater": "greater", - "greater_or_equal": "greater or equal", - "between": "between", - "begins_with": "begins with", - "not_begins_with": "doesn't begin with", - "contains": "contains", - "not_contains": "doesn't contain", - "ends_with": "ends with", - "not_ends_with": "doesn't end with", - "is_empty": "is empty", - "is_not_empty": "is not empty", - "is_null": "is null", - "is_not_null": "is not null" - }, - - "errors": { - "no_filter": "No filter selected", - "empty_group": "The group is empty", - "radio_empty": "No value selected", - "checkbox_empty": "No value selected", - "select_empty": "No value selected", - "string_empty": "Empty value", - "string_exceed_min_length": "Must contain at least {0} characters", - "string_exceed_max_length": "Must not contain more than {0} characters", - "string_invalid_format": "Invalid format ({0})", - "number_nan": "Not a number", - "number_not_integer": "Not an integer", - "number_not_double": "Not a real number", - "number_exceed_min": "Must be greater than {0}", - "number_exceed_max": "Must be lower than {0}", - "number_wrong_step": "Must be a multiple of {0}", - "datetime_empty": "Empty value", - "datetime_invalid": "Invalid date format ({0})", - "datetime_exceed_min": "Must be after {0}", - "datetime_exceed_max": "Must be before {0}", - "boolean_not_valid": "Not a boolean", - "operator_not_multiple": "Operator {0} cannot accept multiple values" - } + templates: { + group: null, + rule: null, + filterSelect: null, + operatorSelect: null, + ruleValueSelect: null }, + lang_code: 'en', + lang: {}, + operators: [ - {type: 'equal', nb_inputs: 1, multiple: false, apply_to: ['string', 'number', 'datetime', 'boolean']}, - {type: 'not_equal', nb_inputs: 1, multiple: false, apply_to: ['string', 'number', 'datetime', 'boolean']}, - {type: 'in', nb_inputs: 1, multiple: true, apply_to: ['string', 'number', 'datetime']}, - {type: 'not_in', nb_inputs: 1, multiple: true, apply_to: ['string', 'number', 'datetime']}, - {type: 'less', nb_inputs: 1, multiple: false, apply_to: ['number', 'datetime']}, - {type: 'less_or_equal', nb_inputs: 1, multiple: false, apply_to: ['number', 'datetime']}, - {type: 'greater', nb_inputs: 1, multiple: false, apply_to: ['number', 'datetime']}, - {type: 'greater_or_equal', nb_inputs: 1, multiple: false, apply_to: ['number', 'datetime']}, - {type: 'between', nb_inputs: 2, multiple: false, apply_to: ['number', 'datetime']}, - {type: 'begins_with', nb_inputs: 1, multiple: false, apply_to: ['string']}, - {type: 'not_begins_with', nb_inputs: 1, multiple: false, apply_to: ['string']}, - {type: 'contains', nb_inputs: 1, multiple: false, apply_to: ['string']}, - {type: 'not_contains', nb_inputs: 1, multiple: false, apply_to: ['string']}, - {type: 'ends_with', nb_inputs: 1, multiple: false, apply_to: ['string']}, - {type: 'not_ends_with', nb_inputs: 1, multiple: false, apply_to: ['string']}, - {type: 'is_empty', nb_inputs: 0, multiple: false, apply_to: ['string']}, - {type: 'is_not_empty', nb_inputs: 0, multiple: false, apply_to: ['string']}, - {type: 'is_null', nb_inputs: 0, multiple: false, apply_to: ['string', 'number', 'datetime', 'boolean']}, - {type: 'is_not_null', nb_inputs: 0, multiple: false, apply_to: ['string', 'number', 'datetime', 'boolean']} + 'equal', + 'not_equal', + 'in', + 'not_in', + 'less', + 'less_or_equal', + 'greater', + 'greater_or_equal', + 'between', + 'not_between', + 'begins_with', + 'not_begins_with', + 'contains', + 'not_contains', + 'ends_with', + 'not_ends_with', + 'is_empty', + 'is_not_empty', + 'is_null', + 'is_not_null' ], icons: { - add_group: 'glyphicon glyphicon-plus-sign', - add_rule: 'glyphicon glyphicon-plus', - remove_group: 'glyphicon glyphicon-remove', - remove_rule: 'glyphicon glyphicon-remove', - error: 'glyphicon glyphicon-warning-sign' + add_group: 'bi-plus-circle-fill', + add_rule: 'bi-plus-lg', + remove_group: 'bi-x-lg', + remove_rule: 'bi-x-lg', + error: 'bi-exclamation-triangle' } -}; \ No newline at end of file +}; diff --git a/src/i18n/.wrapper.js b/src/i18n/.wrapper.js new file mode 100644 index 00000000..9cf5498f --- /dev/null +++ b/src/i18n/.wrapper.js @@ -0,0 +1,15 @@ +(function(root, factory) { + if (typeof define == 'function' && define.amd) { + define(['jquery', 'query-builder'], factory); + } + else { + factory(root.jQuery); + } +}(this, function($) { +"use strict"; + +var QueryBuilder = $.fn.queryBuilder; + +@@js + +})); \ No newline at end of file diff --git a/src/i18n/ar.json b/src/i18n/ar.json new file mode 100644 index 00000000..4590e791 --- /dev/null +++ b/src/i18n/ar.json @@ -0,0 +1,57 @@ + { + "__locale": "Arabic (ar)", + "__author": "Mohamed YOUNES, https://github.com/MedYOUNES", + "add_rule": "إضافة حُكم", + "add_group": "إضافة زُمْرَة", + "delete_rule": "حذف", + "delete_group": "حذف", + "conditions": { + "AND": "و", + "OR": "أو" + }, + "operators": { + "equal": "يساوي", + "not_equal": "غير مساوٍ", + "in": "في", + "not_in": "ليس في", + "less": "أقل من", + "less_or_equal": "أصغر أو مساو", + "greater": "أكبر", + "greater_or_equal": "أكبر أو مساو", + "between": "محصور بين", + "not_between": "غير محصور بين", + "begins_with": "يبدأ بـ", + "not_begins_with": "لا يبدأ بـ", + "contains": "يحتوي على", + "not_contains": "لا يحتوي على", + "ends_with": "ينتهي بـ", + "not_ends_with": "لا ينتهي بـ", + "is_empty": "فارغ", + "is_not_empty": "غير فارغ", + "is_null": "صفر", + "is_not_null": "ليس صفرا" + }, + "errors": { + "no_filter": "لم تحدد أي مرشح", + "empty_group": "الزمرة فارغة", + "radio_empty": "لم تحدد أي قيمة", + "checkbox_empty": "لم تحدد أي قيمة", + "select_empty": "لم تحدد أي قيمة", + "string_empty": "النص فارغ", + "string_exceed_min_length": "النص دون الأدنى المسموح به", + "string_exceed_max_length": "النص فوق الأقصى المسموح به", + "string_invalid_format": "تركيبة غير صحيحة", + "number_nan": "ليس عددا", + "number_not_integer": "ليس عددا صحيحا", + "number_not_double": "ليس عددا كسريا", + "number_exceed_min": "العدد أصغر من الأدنى المسموح به", + "number_exceed_max": "العدد أكبر من الأقصى المسموح به", + "number_wrong_step": "أخطأت في حساب مضاعفات العدد", + "datetime_empty": "لم تحدد التاريخ", + "datetime_invalid": "صيغة التاريخ غير صحيحة", + "datetime_exceed_min": "التاريخ دون الأدنى المسموح به", + "datetime_exceed_max": "التاريخ أكبر من الأقصى المسموح به", + "boolean_not_valid": "ليست قيمة منطقية ثنائية", + "operator_not_multiple": "العامل ليس متعدد القيَم" + } + } diff --git a/src/i18n/az.json b/src/i18n/az.json new file mode 100644 index 00000000..5e12334f --- /dev/null +++ b/src/i18n/az.json @@ -0,0 +1,57 @@ +{ + "__locale": "Azerbaijan (az)", + "__author": "Megaplan, mborisv ", + + "add_rule": "Əlavə etmək", + "add_group": "Qrup əlavə etmək", + "delete_rule": "Silmək", + "delete_group": "Silmək", + "conditions": { + "AND": "VƏ", + "OR": "VƏ YA" + }, + "operators": { + "equal": "bərabərdir", + "not_equal": "bərabər deyil", + "in": "qeyd edilmişlərdən", + "not_in": "qeyd olunmamışlardan", + "less": "daha az", + "less_or_equal": "daha az və ya bərabər", + "greater": "daha çox", + "greater_or_equal": "daha çox və ya bərabər", + "between": "arasında", + "begins_with": "başlayır", + "not_begins_with": "başlamır", + "contains": "ibarətdir", + "not_contains": "yoxdur", + "ends_with": "başa çatır", + "not_ends_with": "başa çatmır", + "is_empty": "boş sətir", + "is_not_empty": "boş olmayan sətir", + "is_null": "boşdur", + "is_not_null": "boş deyil" + }, + "errors": { + "no_filter": "Filterlər seçilməyib", + "empty_group": "Qrup boşdur", + "radio_empty": "Məna seçilməyib", + "checkbox_empty": "Məna seçilməyib", + "select_empty": "Məna seçilməyib", + "string_empty": "Doldurulmayıb", + "string_exceed_min_length": "{0} daha çox simvol olmalıdır", + "string_exceed_max_length": "{0} daha az simvol olmalıdır", + "string_invalid_format": "Yanlış format ({0})", + "number_nan": "Rəqəm deyil", + "number_not_integer": "Rəqəm deyil", + "number_not_double": "Rəqəm deyil", + "number_exceed_min": "{0} daha çox olmalıdır", + "number_exceed_max": "{0} daha az olmalıdır", + "number_wrong_step": "{0} bölünən olmalıdır", + "datetime_empty": "Doldurulmayıb", + "datetime_invalid": "Yanlış tarix formatı ({0})", + "datetime_exceed_min": "{0} sonra olmalıdır", + "datetime_exceed_max": "{0} əvvəl olmalıdır", + "boolean_not_valid": "Loqik olmayan", + "operator_not_multiple": "\"{1}\" operatoru çoxlu məna daşımır" + } +} \ No newline at end of file diff --git a/src/i18n/bg.json b/src/i18n/bg.json new file mode 100644 index 00000000..095d01cc --- /dev/null +++ b/src/i18n/bg.json @@ -0,0 +1,61 @@ +{ + "__locale": "Bulgarian (bg)", + "__author": "Valentin Hristov", + + "add_rule": "Добави правило", + "add_group": "Добави група", + "delete_rule": "Изтрий", + "delete_group": "Изтрий", + + "conditions": { + "AND": "И", + "OR": "ИЛИ" + }, + + "operators": { + "equal": "равно", + "not_equal": "различно", + "in": "в", + "not_in": "не е в", + "less": "по-малко", + "less_or_equal": "по-малко или равно", + "greater": "по-голям", + "greater_or_equal": "по-голям или равно", + "between": "между", + "not_between": "не е между", + "begins_with": "започва с", + "not_begins_with": "не започва с", + "contains": "съдържа", + "not_contains": "не съдържа", + "ends_with": "завършва с", + "not_ends_with": "не завършва с", + "is_empty": "е празно", + "is_not_empty": "не е празно", + "is_null": "е нищо", + "is_not_null": "различно от нищо" + }, + + "errors": { + "no_filter": "Не е избран филтър", + "empty_group": "Групата е празна", + "radio_empty": "Не е селектирана стойност", + "checkbox_empty": "Не е селектирана стойност", + "select_empty": "Не е селектирана стойност", + "string_empty": "Празна стойност", + "string_exceed_min_length": "Необходимо е да съдържа поне {0} символа", + "string_exceed_max_length": "Необходимо е да съдържа повече от {0} символа", + "string_invalid_format": "Невалиден формат ({0})", + "number_nan": "Не е число", + "number_not_integer": "Не е цяло число", + "number_not_double": "Не е реално число", + "number_exceed_min": "Трябва да е по-голямо от {0}", + "number_exceed_max": "Трябва да е по-малко от {0}", + "number_wrong_step": "Трябва да е кратно на {0}", + "datetime_empty": "Празна стойност", + "datetime_invalid": "Невалиден формат на дата ({0})", + "datetime_exceed_min": "Трябва да е след {0}", + "datetime_exceed_max": "Трябва да е преди {0}", + "boolean_not_valid": "Не е булева", + "operator_not_multiple": "Оператора \"{1}\" не може да приеме множество стойности" + } +} diff --git a/src/i18n/cs.json b/src/i18n/cs.json new file mode 100644 index 00000000..448cc97d --- /dev/null +++ b/src/i18n/cs.json @@ -0,0 +1,57 @@ +{ + "__locale": "Čeština (cs)", + "__author": "Megaplan, mborisv ", + + "add_rule": "Přidat", + "add_group": "Přidat skupinu", + "delete_rule": "Odstranit", + "delete_group": "Odstranit skupinu", + "conditions": { + "AND": "I", + "OR": "NEBO" + }, + "operators": { + "equal": "stejně", + "not_equal": "liší se", + "in": "z uvedených", + "not_in": "ne z uvedených", + "less": "méně", + "less_or_equal": "méně nebo stejně", + "greater": "více", + "greater_or_equal": "více nebo stejně", + "between": "mezi", + "begins_with": "začíná z", + "not_begins_with": "nezačíná z", + "contains": "obsahuje", + "not_contains": "neobsahuje", + "ends_with": "končí na", + "not_ends_with": "nekončí na", + "is_empty": "prázdný řádek", + "is_not_empty": "neprázdný řádek", + "is_null": "prázdno", + "is_not_null": "plno" + }, + "errors": { + "no_filter": "není vybraný filtr", + "empty_group": "prázdná skupina", + "radio_empty": "Není udaná hodnota", + "checkbox_empty": "Není udaná hodnota", + "select_empty": "Není udaná hodnota", + "string_empty": "Nevyplněno", + "string_exceed_min_length": "Musí obsahovat více {0} symbolů", + "string_exceed_max_length": "Musí obsahovat méně {0} symbolů", + "string_invalid_format": "Nesprávný formát ({0})", + "number_nan": "Žádné číslo", + "number_not_integer": "Žádné číslo", + "number_not_double": "Žádné číslo", + "number_exceed_min": "Musí být více {0}", + "number_exceed_max": "Musí být méně {0}", + "number_wrong_step": "Musí být násobkem {0}", + "datetime_empty": "Nevyplněno", + "datetime_invalid": "Nesprávný formát datumu ({0})", + "datetime_exceed_min": "Musí být po {0}", + "datetime_exceed_max": "Musí být do {0}", + "boolean_not_valid": "Nelogické", + "operator_not_multiple": "Operátor \"{1}\" nepodporuje mnoho hodnot" + } +} \ No newline at end of file diff --git a/src/i18n/da.json b/src/i18n/da.json index 6aa2df77..784c80b6 100644 --- a/src/i18n/da.json +++ b/src/i18n/da.json @@ -1,5 +1,6 @@ { - "__copyright": "Oversat af Jna Borup Coyle, github@coyle.dk", + "__locale": "Danish (da)", + "__author": "Jna Borup Coyle, github@coyle.dk", "add_rule": "Tilføj regel", "add_group": "Tilføj gruppe", diff --git a/src/i18n/de.json b/src/i18n/de.json index a7747d17..82104597 100644 --- a/src/i18n/de.json +++ b/src/i18n/de.json @@ -1,5 +1,6 @@ { - "__copyright": "German translation by \"raimu\"", + "__locale": "German (de)", + "__author": "\"raimu\"", "add_rule": "neue Regel", "add_group": "neue Gruppe", @@ -20,6 +21,8 @@ "less_or_equal": "kleiner gleich", "greater": "größer", "greater_or_equal": "größer gleich", + "between": "zwischen", + "not_between": "nicht zwischen", "begins_with": "beginnt mit", "not_begins_with": "beginnt nicht mit", "contains": "enthält", @@ -52,4 +55,4 @@ "datetime_exceed_min": "Muss nach dem {0} sein", "datetime_exceed_max": "Muss vor dem {0} sein" } -} \ No newline at end of file +} diff --git a/src/i18n/el.json b/src/i18n/el.json new file mode 100644 index 00000000..0c988473 --- /dev/null +++ b/src/i18n/el.json @@ -0,0 +1,57 @@ +{ + "__locale": "Greek (el)", + "__author": "Stelios Patsatzis, https://www.linkedin.com/in/stelios-patsatzis-89841561", + "add_rule": "Προσθήκη Συνθήκης", + "add_group": "Προσθήκη Ομάδας", + "delete_rule": "Διαγραφή", + "delete_group": "Διαγραφή", + "conditions": { + "AND": "Λογικό ΚΑΙ", + "OR": "Λογικό Η" + }, + "operators": { + "equal": "Ισούται με", + "not_equal": "Διάφορο από ", + "in": "Περιέχει", + "not_in": "Δεν Περιέχει", + "less": "Λιγότερο από", + "less_or_equal": "Λιγότερο ή Ίσο", + "greater": "Μεγαλύτερο από", + "greater_or_equal": "Μεγαλύτερο ή Ίσο", + "between": "Μεταξύ", + "not_between": "Εκτός", + "begins_with": "Αρχίζει με", + "not_begins_with": "Δεν αρχίζει με", + "contains": "Περιέχει", + "not_contains": "Δεν περιέχει", + "ends_with": "Τελειώνει σε", + "not_ends_with": "Δεν τελειώνει σε", + "is_empty": "Είναι άδειο", + "is_not_empty": "Δεν είναι άδειο", + "is_null": "Είναι NULL", + "is_not_null": "Δεν είναι NULL" + }, + "errors": { + "no_filter": "Χωρίς φίλτρα", + "empty_group": "Άδεια ομάδα", + "radio_empty": "Χωρίς τιμή", + "checkbox_empty": "Χωρίς τιμή", + "select_empty": "Χωρίς τιμή", + "string_empty": "Χωρίς τιμή", + "string_exceed_min_length": "Ελάχιστο όριο {0} χαρακτήρων", + "string_exceed_max_length": "Μέγιστο όριο {0} χαρακτήρων", + "string_invalid_format": "Λανθασμένη μορφή ({0})", + "number_nan": "Δεν είναι αριθμός", + "number_not_integer": "Δεν είναι ακέραιος αριθμός", + "number_not_double": "Δεν είναι πραγματικός αριθμός", + "number_exceed_min": "Πρέπει να είναι μεγαλύτερο απο {0}", + "number_exceed_max": "Πρέπει να είναι μικρότερο απο {0}", + "number_wrong_step": "Πρέπει να είναι πολλαπλάσιο του {0}", + "datetime_empty": "Χωρίς τιμή", + "datetime_invalid": "Λανθασμένη μορφή ημερομηνίας ({0})", + "datetime_exceed_min": "Νεότερο από {0}", + "datetime_exceed_max": "Παλαιότερο από {0}", + "boolean_not_valid": "Δεν είναι BOOLEAN", + "operator_not_multiple": "Η συνθήκη \"{1}\" δεν μπορεί να δεχθεί πολλαπλές τιμές" + } +} \ No newline at end of file diff --git a/src/i18n/en.json b/src/i18n/en.json index 8fe2087a..15bbb139 100644 --- a/src/i18n/en.json +++ b/src/i18n/en.json @@ -1,5 +1,6 @@ { - "__copyright": "Reference language file", + "__locale": "English (en)", + "__author": "Damien \"Mistic\" Sorel, http://www.strangeplanet.fr", "add_rule": "Add rule", "add_group": "Add group", @@ -21,6 +22,7 @@ "greater": "greater", "greater_or_equal": "greater or equal", "between": "between", + "not_between": "not between", "begins_with": "begins with", "not_begins_with": "doesn't begin with", "contains": "contains", @@ -49,11 +51,13 @@ "number_exceed_min": "Must be greater than {0}", "number_exceed_max": "Must be lower than {0}", "number_wrong_step": "Must be a multiple of {0}", + "number_between_invalid": "Invalid values, {0} is greater than {1}", "datetime_empty": "Empty value", "datetime_invalid": "Invalid date format ({0})", "datetime_exceed_min": "Must be after {0}", "datetime_exceed_max": "Must be before {0}", + "datetime_between_invalid": "Invalid values, {0} is greater than {1}", "boolean_not_valid": "Not a boolean", - "operator_not_multiple": "Operator {0} cannot accept multiple values" + "operator_not_multiple": "Operator \"{1}\" cannot accept multiple values" } -} \ No newline at end of file +} diff --git a/src/i18n/eo.json b/src/i18n/eo.json new file mode 100644 index 00000000..b3c9166d --- /dev/null +++ b/src/i18n/eo.json @@ -0,0 +1,63 @@ +{ + "__locale": "Esperanto (eo)", + "__author": "Robin van der Vliet, https://robinvandervliet.com/", + + "add_rule": "Aldoni regulon", + "add_group": "Aldoni grupon", + "delete_rule": "Forigi", + "delete_group": "Forigi", + + "conditions": { + "AND": "KAJ", + "OR": "AŬ" + }, + + "operators": { + "equal": "estas egala al", + "not_equal": "ne estas egala al", + "in": "estas en", + "not_in": "ne estas en", + "less": "estas malpli ol", + "less_or_equal": "estas malpli ol aŭ egala al", + "greater": "estas pli ol", + "greater_or_equal": "estas pli ol aŭ egala al", + "between": "estas inter", + "not_between": "ne estas inter", + "begins_with": "komenciĝas per", + "not_begins_with": "ne komenciĝas per", + "contains": "enhavas", + "not_contains": "ne enhavas", + "ends_with": "finiĝas per", + "not_ends_with": "ne finiĝas per", + "is_empty": "estas malplena", + "is_not_empty": "ne estas malplena", + "is_null": "estas senvalora", + "is_not_null": "ne estas senvalora" + }, + + "errors": { + "no_filter": "Neniu filtrilo elektita", + "empty_group": "La grupo estas malplena", + "radio_empty": "Neniu valoro elektita", + "checkbox_empty": "Neniu valoro elektita", + "select_empty": "Neniu valoro elektita", + "string_empty": "Malplena valoro", + "string_exceed_min_length": "Devas enhavi pli ol {0} signojn", + "string_exceed_max_length": "Devas ne enhavi pli ol {0} signojn", + "string_invalid_format": "Nevalida strukturo ({0})", + "number_nan": "Ne estas nombro", + "number_not_integer": "Ne estas entjera nombro", + "number_not_double": "Ne estas reela nombro", + "number_exceed_min": "Devas esti pli ol {0}", + "number_exceed_max": "Devas esti malpli ol {0}", + "number_wrong_step": "Devas esti oblo de {0}", + "number_between_invalid": "Nevalidaj valoroj, {0} estas pli ol {1}", + "datetime_empty": "Malplena valoro", + "datetime_invalid": "Nevalida dato ({0})", + "datetime_exceed_min": "Devas esti post {0}", + "datetime_exceed_max": "Devas esti antaŭ {0}", + "datetime_between_invalid": "Nevalidaj valoroj, {0} estas post {1}", + "boolean_not_valid": "Ne estas bulea valoro", + "operator_not_multiple": "La operacio \"{1}\" ne akceptas plurajn valorojn" + } +} diff --git a/src/i18n/es.json b/src/i18n/es.json index 8349fba4..3374aae1 100644 --- a/src/i18n/es.json +++ b/src/i18n/es.json @@ -1,5 +1,6 @@ { - "__copyright": "Spanish translation by \"pyarza\"", + "__locale": "Spanish (es)", + "__author": "\"pyarza\", \"kddlb\"", "add_rule": "Añadir regla", "add_group": "Añadir grupo", @@ -21,36 +22,42 @@ "greater": "mayor", "greater_or_equal": "mayor o igual", "between": "entre", + "not_between": "no está entre", "begins_with": "empieza por", "not_begins_with": "no empieza por", "contains": "contiene", "not_contains": "no contiene", "ends_with": "acaba con", "not_ends_with": "no acaba con", - "is_empty": "esta vacio", - "is_not_empty": "no esta vacio", + "is_empty": "está vacío", + "is_not_empty": "no está vacío", "is_null": "es nulo", "is_not_null": "no es nulo" }, "errors": { - "no_filter": "No se ha seleccionado ningun filtro", - "empty_group": "El grupo esta vacio", - "radio_empty": "Ningun valor seleccionado", - "checkbox_empty": "Ningun valor seleccionado", - "select_empty": "Ningun valor seleccionado", - "string_empty": "Cadena vacia", + "no_filter": "No se ha seleccionado ningún filtro", + "empty_group": "El grupo está vacío", + "radio_empty": "Ningún valor seleccionado", + "checkbox_empty": "Ningún valor seleccionado", + "select_empty": "Ningún valor seleccionado", + "string_empty": "Cadena vacía", "string_exceed_min_length": "Debe contener al menos {0} caracteres", - "string_exceed_max_length": "No debe contener mas de {0} caracteres", - "string_invalid_format": "Formato invalido ({0})", - "number_nan": "No es un numero", - "number_not_integer": "No es un numero entero", - "number_not_double": "No es un numero real", + "string_exceed_max_length": "No debe contener más de {0} caracteres", + "string_invalid_format": "Formato inválido ({0})", + "number_nan": "No es un número", + "number_not_integer": "No es un número entero", + "number_not_double": "No es un número real", "number_exceed_min": "Debe ser mayor que {0}", - "number_exceed_max": "Debe ser menot que {0}", - "number_wrong_step": "Debe ser multiplo de {0}", - "datetime_invalid": "Formato de fecha invalido ({0})", + "number_exceed_max": "Debe ser menor que {0}", + "number_wrong_step": "Debe ser múltiplo de {0}", + "datetime_invalid": "Formato de fecha inválido ({0})", "datetime_exceed_min": "Debe ser posterior a {0}", - "datetime_exceed_max": "Debe ser anterior a {0}" + "datetime_exceed_max": "Debe ser anterior a {0}", + "number_between_invalid": "Valores Inválidos, {0} es mayor que {1}", + "datetime_empty": "Campo vacio", + "datetime_between_invalid": "Valores Inválidos, {0} es mayor que {1}", + "boolean_not_valid": "No es booleano", + "operator_not_multiple": "El operador \"{1}\" no puede aceptar valores multiples" } -} \ No newline at end of file +} diff --git a/src/i18n/fa-IR.json b/src/i18n/fa-IR.json new file mode 100644 index 00000000..55a6e456 --- /dev/null +++ b/src/i18n/fa-IR.json @@ -0,0 +1,61 @@ +{ + "__locale": "Farsi (fa-ir)", + "__author": "Behzad Sedighzade, behzad.sedighzade@gmail.com", + + "add_rule": "افزودن قاعده", + "add_group": "افزودن گروه", + "delete_rule": "حذف قاعده", + "delete_group": "حذف گروه", + + "conditions": { + "AND": "و", + "OR": "یا" + }, + + "operators": { + "equal": "برابر با", + "not_equal": "مخالف", + "in": "شامل مجموعه شود", + "not_in": "شامل مجموعه نشود", + "less": "کمتر از", + "less_or_equal": "کمتر یا مساوی با", + "greater": "بزرگتر از", + "greater_or_equal": "بزرگتر یا مساوی با", + "between": "مابین", + "not_between": "مابین نباشد", + "begins_with": "شروع شود با", + "not_begins_with": "شروع نشود با", + "contains": "شامل شود", + "not_contains": "شامل نشود", + "ends_with": "خاتمه یابد با", + "not_ends_with": "خاتمه نیابد با", + "is_empty": "خالی باشد", + "is_not_empty": "خالی نباشد", + "is_null": "باشد ( null ) پوچ", + "is_not_null": "نباشد( null ) پوچ " + }, + + "errors": { + "no_filter": "هیچ قاعده ای انتخاب نشده است", + "empty_group": "گروه خالی است", + "radio_empty": "مقداری انتخاب نشده است", + "checkbox_empty": "مقداری انتخاب نشده است", + "select_empty": "مقداری انتخاب نشده است", + "string_empty": "مقدار متنی خالی است", + "string_exceed_min_length": "رشته حداقل باید {0} عدد حرف داشته باشد", + "string_exceed_max_length": "رشته حداکثر {0} عدد حرف می تواند قبول کند", + "string_invalid_format": "قالب رشته {0} نامعتبر ست", + "number_nan": "عدد وارد کنید", + "number_not_integer": "مقدار صحیح وارد کنید", + "number_not_double": "مقدار اعشاری وارد کنید", + "number_exceed_min": "باید از {0} بزرگتر باشد", + "number_exceed_max": "باید از {0} کمتر باشد", + "number_wrong_step": "باید مضربی از {0} باشد", + "datetime_empty": "مقدار تاریخ خالی وارد شده!", + "datetime_invalid": "قالب تاریخ ( {0} ) اشتباه است", + "datetime_exceed_min": "باید بعد از {0} باشد", + "datetime_exceed_max": "باید قبل از {0} باشد", + "boolean_not_valid": "مقدار دودویی وارد کنید", + "operator_not_multiple": "اپراتور \"{1}\" نمی تواند چند مقدار قبول کند" + } +} diff --git a/src/i18n/fr.json b/src/i18n/fr.json index 1df40bc6..33b27bb6 100644 --- a/src/i18n/fr.json +++ b/src/i18n/fr.json @@ -1,5 +1,6 @@ { - "__copyright": "French translation by Damien \"Mistic\" Sorel", + "__locale": "French (fr)", + "__author": "Damien \"Mistic\" Sorel, http://www.strangeplanet.fr", "add_rule": "Ajouter une règle", "add_group": "Ajouter un groupe", @@ -12,15 +13,16 @@ }, "operators": { - "equal": "égal", - "not_equal": "non égal", - "in": "dans", - "not_in": "pas dans", - "less": "inférieur", - "less_or_equal": "inférieur ou égal", - "greater": "supérieur", - "greater_or_equal": "supérieur ou égal", - "between": "entre", + "equal": "est égal à", + "not_equal": "n'est pas égal à", + "in": "est compris dans", + "not_in": "n'est pas compris dans", + "less": "est inférieur à", + "less_or_equal": "est inférieur ou égal à", + "greater": "est supérieur à", + "greater_or_equal": "est supérieur ou égal à", + "between": "est entre", + "not_between": "n'est pas entre", "begins_with": "commence par", "not_begins_with": "ne commence pas par", "contains": "contient", @@ -49,11 +51,13 @@ "number_exceed_min": "Doit être plus grand que {0}", "number_exceed_max": "Doit être plus petit que {0}", "number_wrong_step": "Doit être un multiple de {0}", + "number_between_invalid": "Valeurs invalides, {0} est plus grand que {1}", "datetime_empty": "Valeur vide", "datetime_invalid": "Fomat de date invalide ({0})", "datetime_exceed_min": "Doit être après {0}", "datetime_exceed_max": "Doit être avant {0}", + "datetime_between_invalid": "Valeurs invalides, {0} est plus grand que {1}", "boolean_not_valid": "N'est pas un booléen", - "operator_not_multiple": "L'opérateur {0} ne peut utiliser plusieurs valeurs" + "operator_not_multiple": "L'opérateur \"{1}\" ne peut utiliser plusieurs valeurs" } -} \ No newline at end of file +} diff --git a/src/i18n/he.json b/src/i18n/he.json new file mode 100644 index 00000000..d1009042 --- /dev/null +++ b/src/i18n/he.json @@ -0,0 +1,61 @@ +{ + "__locale": "Hebrew (he)", + "__author": "Kfir Stri https://github.com/kfirstri", + + "add_rule": "הוסף כלל", + "add_group": "הוסף קבוצה", + "delete_rule": "מחק", + "delete_group": "מחק", + + "conditions": { + "AND": "וגם", + "OR": "או" + }, + + "operators": { + "equal": "שווה ל", + "not_equal": "שונה מ", + "in": "חלק מ", + "not_in": "לא חלק מ", + "less": "פחות מ", + "less_or_equal": "פחות או שווה ל", + "greater": "גדול מ", + "greater_or_equal": "גדול או שווה ל", + "between": "בין", + "not_between": "לא בין", + "begins_with": "מתחיל ב", + "not_begins_with": "לא מתחיל ב", + "contains": "מכיל", + "not_contains": "לא מכיל", + "ends_with": "מסתיים ב", + "not_ends_with": "לא מסתיים ב", + "is_empty": "ריק", + "is_not_empty": "לא ריק", + "is_null": "חסר ערך", + "is_not_null": "לא חסר ערך" + }, + + "errors": { + "no_filter": "לא נבחרו מסננים", + "empty_group": "הקבוצה רירקה", + "radio_empty": "לא נבחר אף ערך", + "checkbox_empty": "לא נבחר אף ערך", + "select_empty": "לא נבחר אף ערך", + "string_empty": "חסר ערך", + "string_exceed_min_length": "המחרוזת חייבת להכיל לפחות {0} תווים", + "string_exceed_max_length": "המחרוזת לא יכולה להכיל יותר מ{0} תווים", + "string_invalid_format": "המחרוזת בפורמט שגוי ({0})", + "number_nan": "זהו לא מספר", + "number_not_integer": "המספר אינו מספר שלם", + "number_not_double": "המספר אינו מספר עשרוני", + "number_exceed_min": "המספר צריך להיות גדול מ {0}", + "number_exceed_max": "המספר צריך להיות קטן מ{0}", + "number_wrong_step": "המספר צריך להיות כפולה של {0}", + "datetime_empty": "תאריך ריק", + "datetime_invalid": "פורמט תאריך שגוי ({0})", + "datetime_exceed_min": "התאריך חייב להיות אחרי {0}", + "datetime_exceed_max": "התאריך חייב להיות לפני {0}", + "boolean_not_valid": "זהו לא בוליאני", + "operator_not_multiple": "האופרטור \"{1}\" לא יכול לקבל ערכים מרובים" + } +} \ No newline at end of file diff --git a/src/i18n/hu.json b/src/i18n/hu.json new file mode 100644 index 00000000..22fa5e4c --- /dev/null +++ b/src/i18n/hu.json @@ -0,0 +1,63 @@ +{ + "__locale": "Hungarian - Magyar (hu)", + "__author": "Szabó Attila \"Tailor993\", https://www.tailor993.hu", + + "add_rule": "Feltétel hozzáadása", + "add_group": "Csoport hozzáadása", + "delete_rule": "Feltétel törlése", + "delete_group": "Csoport törlése", + + "conditions": { + "AND": "ÉS", + "OR": "VAGY" + }, + + "operators": { + "equal": "egyenlő", + "not_equal": "nem egyenlő", + "in": "bennevan", + "not_in": "nincs benne", + "less": "kisebb", + "less_or_equal": "kisebb vagy egyenlő", + "greater": "nagyobb", + "greater_or_equal": "nagyobb vagy egyenlő", + "between": "közötte", + "not_between": "nincs közötte", + "begins_with": "ezzel kezdődik", + "not_begins_with": "ezzel nem kezdődik", + "contains": "tartalmazza", + "not_contains": "nem tartalmazza", + "ends_with": "erre végződik", + "not_ends_with": "errre nem végződik", + "is_empty": "üres", + "is_not_empty": "nem üres", + "is_null": "null", + "is_not_null": "nem null" + }, + + "errors": { + "no_filter": "Nincs kiválasztott feltétel", + "empty_group": "A csoport üres", + "radio_empty": "Nincs kiválasztott érték", + "checkbox_empty": "Nincs kiválasztott érték", + "select_empty": "Nincs kiválasztott érték", + "string_empty": "Üres érték", + "string_exceed_min_length": "A megadott szöveg rövidebb a várt {0} karakternél", + "string_exceed_max_length": "A megadott szöveg nem tartalmazhat többet, mint {0} karaktert", + "string_invalid_format": "Nem megfelelő formátum ({0})", + "number_nan": "Nem szám", + "number_not_integer": "Nem egész szám (integer)", + "number_not_double": "Nem valós szám", + "number_exceed_min": "Nagyobbnak kell lennie, mint {0}", + "number_exceed_max": "Kisebbnek kell lennie, mint {0}", + "number_wrong_step": "{0} többszörösének kell lennie.", + "number_between_invalid": "INem megfelelő érték, {0} nagyobb, mint {1}", + "datetime_empty": "Üres érték", + "datetime_invalid": "nem megfelelő dátum formátum ({0})", + "datetime_exceed_min": "A dátumnak későbbinek kell lennie, mint{0}", + "datetime_exceed_max": "A dátumnak korábbinak kell lennie, mint {0}", + "datetime_between_invalid": "Nem megfelelő értékek, {0} nagyobb, mint {1}", + "boolean_not_valid": "Nem igaz/hamis (boolean)", + "operator_not_multiple": "Ez a művelet: \"{1}\" nem fogadhat el több értéket" + } +} diff --git a/src/i18n/it.json b/src/i18n/it.json index ce3f18bf..076cc172 100644 --- a/src/i18n/it.json +++ b/src/i18n/it.json @@ -1,5 +1,6 @@ { - "__copyright": "Italian translation", + "__locale": "Italian (it)", + "__author": "davegraziosi, Giuseppe Lodi Rizzini", "add_rule": "Aggiungi regola", "add_group": "Aggiungi gruppo", @@ -20,6 +21,8 @@ "less_or_equal": "minore o uguale", "greater": "maggiore", "greater_or_equal": "maggiore o uguale", + "between" : "compreso tra", + "not_between" : "non compreso tra", "begins_with": "inizia con", "not_begins_with": "non inizia con", "contains": "contiene", @@ -30,5 +33,31 @@ "is_not_empty": "non è vuoto", "is_null": "è nullo", "is_not_null": "non è nullo" + }, + + "errors": { + "no_filter": "Nessun filtro selezionato", + "empty_group": "Il gruppo è vuoto", + "radio_empty": "No value selected", + "checkbox_empty": "Nessun valore selezionato", + "select_empty": "Nessun valore selezionato", + "string_empty": "Valore vuoto", + "string_exceed_min_length": "Deve contenere almeno {0} caratteri", + "string_exceed_max_length": "Non deve contenere più di {0} caratteri", + "string_invalid_format": "Formato non valido ({0})", + "number_nan": "Non è un numero", + "number_not_integer": "Non è un intero", + "number_not_double": "Non è un numero con la virgola", + "number_exceed_min": "Deve essere maggiore di {0}", + "number_exceed_max": "Deve essere minore di {0}", + "number_wrong_step": "Deve essere multiplo di {0}", + "number_between_invalid": "Valori non validi, {0} è maggiore di {1}", + "datetime_empty": "Valore vuoto", + "datetime_invalid": "Formato data non valido ({0})", + "datetime_exceed_min": "Deve essere successivo a {0}", + "datetime_exceed_max": "Deve essere precedente a {0}", + "datetime_between_invalid": "Valori non validi, {0} è maggiore di {1}", + "boolean_not_valid": "Non è un booleano", + "operator_not_multiple": "L'Operatore {0} non può accettare valori multipli" } -} \ No newline at end of file +} diff --git a/src/i18n/lt.json b/src/i18n/lt.json new file mode 100644 index 00000000..c95c4f08 --- /dev/null +++ b/src/i18n/lt.json @@ -0,0 +1,63 @@ +{ + "__locale": "Lithuanian (lt)", + "__author": "Dalius Guzauskas (aka Tichij), https://lt.linkedin.com/in/daliusg", + + "add_rule": "Pridėti taisyklę", + "add_group": "Pridėti grupę", + "delete_rule": "Ištrinti", + "delete_group": "Ištrinti", + + "conditions": { + "AND": "IR", + "OR": "ARBA" + }, + + "operators": { + "equal": "lygu", + "not_equal": "nėra lygu", + "in": "iš nurodytų", + "not_in": "ne iš nurodytų", + "less": "mažiau", + "less_or_equal": "mažiau arba lygu", + "greater": "daugiau", + "greater_or_equal": "daugiau arba lygu", + "between": "tarp", + "not_between": "nėra tarp", + "begins_with": "prasideda", + "not_begins_with": "neprasideda", + "contains": "turi", + "not_contains": "neturi", + "ends_with": "baigiasi", + "not_ends_with": "nesibaigia", + "is_empty": "tuščia", + "is_not_empty": "ne tuščia", + "is_null": "neapibrėžta", + "is_not_null": "nėra neapibrėžta" + }, + + "errors": { + "no_filter": "Nepasirinktas filtras", + "empty_group": "Grupė tuščia", + "radio_empty": "Nepasirinkta reikšmė", + "checkbox_empty": "Nepasirinkta reikšmė", + "select_empty": "Nepasirinkta reikšmė", + "string_empty": "Tuščia reikšmė", + "string_exceed_min_length": "Turi būti bent {0} simbolių", + "string_exceed_max_length": "Turi būti ne daugiau kaip {0} simbolių", + "string_invalid_format": "Klaidingas formatas ({0})", + "number_nan": "Nėra skaičius", + "number_not_integer": "Ne sveikasis skaičius", + "number_not_double": "Ne realusis skaičius", + "number_exceed_min": "Turi būti daugiau už {0}", + "number_exceed_max": "Turi būti mažiau už {0}", + "number_wrong_step": "Turi būti {0} kartotinis", + "number_between_invalid": "Klaidingos reikšmės, {0} yra daugiau už {1}", + "datetime_empty": "Tuščia reikšmė", + "datetime_invalid": "Klaidingas datos formatas ({0})", + "datetime_exceed_min": "Turi būti po {0}", + "datetime_exceed_max": "Turi būti prieš {0}", + "datetime_between_invalid": "Klaidingos reikšmės, {0} yra daugiau už {1}", + "boolean_not_valid": "Nėra loginis tipas", + "operator_not_multiple": "Operatorius \"{1}\" negali priimti kelių reikšmių" + } +} diff --git a/src/i18n/nl.json b/src/i18n/nl.json index 14e4a198..06199640 100644 --- a/src/i18n/nl.json +++ b/src/i18n/nl.json @@ -1,5 +1,6 @@ { - "__copyright": "Dutch translation by \"Roywcm\"", + "__locale": "Dutch (nl)", + "__author": "\"Roywcm\"", "add_rule": "Nieuwe regel", "add_group": "Nieuwe groep", @@ -21,6 +22,7 @@ "greater": "groter", "greater_or_equal": "groter of gelijk", "between": "tussen", + "not_between": "niet tussen", "begins_with": "begint met", "not_begins_with": "begint niet met", "contains": "bevat", @@ -53,4 +55,4 @@ "datetime_exceed_min": "Dient na {0}", "datetime_exceed_max": "Dient voor {0}" } -} \ No newline at end of file +} diff --git a/src/i18n/no.json b/src/i18n/no.json index b6d0184c..6f65e25e 100644 --- a/src/i18n/no.json +++ b/src/i18n/no.json @@ -1,5 +1,6 @@ { - "__copyright": "Oversat af Jna Borup Coyle, github@coyle.dk", + "__locale": "Norwegian (no)", + "__author": "Jna Borup Coyle, github@coyle.dk", "add_rule": "Legg til regel", "add_group": "Legg til gruppe", diff --git a/src/i18n/pl.json b/src/i18n/pl.json index a9da547b..9cddba15 100644 --- a/src/i18n/pl.json +++ b/src/i18n/pl.json @@ -1,5 +1,6 @@ { - "__copyright": "Polish translation by Artur Smolarek", + "__locale": "Polish (pl)", + "__author": "Artur Smolarek", "add_rule": "Dodaj regułę", "add_group": "Dodaj grupę", @@ -7,8 +8,8 @@ "delete_group": "Usuń", "conditions": { - "AND": "AND", - "OR": "OR" + "AND": "ORAZ", + "OR": "LUB" }, "operators": { @@ -21,6 +22,7 @@ "greater": "większe", "greater_or_equal": "większe lub równe", "between": "pomiędzy", + "not_between": "nie jest pomiędzy", "begins_with": "rozpoczyna się od", "not_begins_with": "nie rozpoczyna się od", "contains": "zawiera", @@ -49,8 +51,11 @@ "number_exceed_min": "Musi być większe niż {0}", "number_exceed_max": "Musi być mniejsze niż {0}", "number_wrong_step": "Musi być wielokrotnością {0}", + "datetime_empty": "Nie wybrano wartości", "datetime_invalid": "Nieprawidłowy format daty ({0})", "datetime_exceed_min": "Musi być po {0}", - "datetime_exceed_max": "Musi być przed {0}" + "datetime_exceed_max": "Musi być przed {0}", + "boolean_not_valid": "Niepoprawna wartość logiczna", + "operator_not_multiple": "Operator \"{1}\" nie przyjmuje wielu wartości" } } \ No newline at end of file diff --git a/src/i18n/pt-BR.json b/src/i18n/pt-BR.json index 41b855f6..f822aa83 100644 --- a/src/i18n/pt-BR.json +++ b/src/i18n/pt-BR.json @@ -1,8 +1,9 @@ { - "__copyright": "Portuguese Brazilian translation by Leandro Gehlen (leandrogehlen@gmail.com)", + "__locale": "Brazilian Portuguese (pr-BR)", + "__author": "Leandro Gehlen, leandrogehlen@gmail.com; Marcos Ferretti, marcosvferretti@gmail.com", "add_rule": "Nova Regra", - "add_group": "Novo Gruop", + "add_group": "Novo Grupo", "delete_rule": "Excluir", "delete_group": "Excluir", @@ -20,7 +21,8 @@ "less_or_equal": "Menor ou igual", "greater": "Maior", "greater_or_equal": "Maior ou igual", - "between": "entre", + "between": "Entre", + "not_between": "Não entre", "begins_with": "Iniciando com", "not_begins_with": "Não iniciando com", "contains": "Contém", @@ -41,7 +43,7 @@ "select_empty": "Nenhum valor selecionado", "string_empty": "Valor vazio", "string_exceed_min_length": "É necessário conter pelo menos {0} caracteres", - "string_exceed_max_length": "É necessário conterm mais de {0} caracteres", + "string_exceed_max_length": "É necessário conter mais de {0} caracteres", "string_invalid_format": "Formato inválido ({0})", "number_nan": "Não é um número", "number_not_integer": "Não é um número inteiro", @@ -51,6 +53,9 @@ "number_wrong_step": "É necessário ser múltiplo de {0}", "datetime_invalid": "Formato de data inválido ({0})", "datetime_exceed_min": "É necessário ser superior a {0}", - "datetime_exceed_max": "É necessário ser inferior a {0}" + "datetime_exceed_max": "É necessário ser inferior a {0}", + "datetime_empty": "Nenhuma data selecionada", + "boolean_not_valid": "Não é um valor booleano", + "operator_not_multiple": "O operador \"{1}\" não aceita valores múltiplos" } } \ No newline at end of file diff --git a/dist/i18n/pt-BR.js b/src/i18n/pt-PT.json similarity index 69% rename from dist/i18n/pt-BR.js rename to src/i18n/pt-PT.json index f90e3466..34a7ca0e 100644 --- a/dist/i18n/pt-BR.js +++ b/src/i18n/pt-PT.json @@ -1,30 +1,29 @@ -/*! - * jQuery QueryBuilder 2.0.0 - * Portuguese Brazilian translation by Leandro Gehlen (leandrogehlen@gmail.com) - * Licensed under MIT (http://opensource.org/licenses/MIT) - */ +{ + "__locale": "Portuguese (pt-PT)", + "__author": "Miguel Guerreiro, migas.csi@gmail.com", -jQuery.fn.queryBuilder.defaults({ lang: { "add_rule": "Nova Regra", - "add_group": "Novo Gruop", + "add_group": "Novo Grupo", "delete_rule": "Excluir", "delete_group": "Excluir", + "conditions": { "AND": "E", "OR": "OU" }, + "operators": { - "equal": "Igual", - "not_equal": "Diferente", + "equal": "Igual a", + "not_equal": "Diferente de", "in": "Contido", "not_in": "Não contido", - "less": "Menor", - "less_or_equal": "Menor ou igual", - "greater": "Maior", - "greater_or_equal": "Maior ou igual", - "between": "entre", - "begins_with": "Iniciando com", - "not_begins_with": "Não iniciando com", + "less": "Menor que", + "less_or_equal": "Menor ou igual a", + "greater": "Maior que", + "greater_or_equal": "Maior ou igual que", + "between": "Entre", + "begins_with": "Começar por", + "not_begins_with": "Não a começar por", "contains": "Contém", "not_contains": "Não contém", "ends_with": "Terminando com", @@ -34,6 +33,7 @@ jQuery.fn.queryBuilder.defaults({ lang: { "is_null": "É nulo", "is_not_null": "Não é nulo" }, + "errors": { "no_filter": "Nenhum filtro selecionado", "empty_group": "O grupo está vazio", @@ -42,7 +42,7 @@ jQuery.fn.queryBuilder.defaults({ lang: { "select_empty": "Nenhum valor selecionado", "string_empty": "Valor vazio", "string_exceed_min_length": "É necessário conter pelo menos {0} caracteres", - "string_exceed_max_length": "É necessário conterm mais de {0} caracteres", + "string_exceed_max_length": "É necessário conter mais de {0} caracteres", "string_invalid_format": "Formato inválido ({0})", "number_nan": "Não é um número", "number_not_integer": "Não é um número inteiro", @@ -54,4 +54,4 @@ jQuery.fn.queryBuilder.defaults({ lang: { "datetime_exceed_min": "É necessário ser superior a {0}", "datetime_exceed_max": "É necessário ser inferior a {0}" } -}}); \ No newline at end of file +} \ No newline at end of file diff --git a/src/i18n/ro.json b/src/i18n/ro.json index efe56c28..b2a6eae3 100644 --- a/src/i18n/ro.json +++ b/src/i18n/ro.json @@ -1,5 +1,6 @@ { - "__copyright": "Romanian translation by ArianServ", + "__locale": "Romanian (ro)", + "__author": "ArianServ, totpero", "add_rule": "Adaugă regulă", "add_group": "Adaugă grup", @@ -16,10 +17,12 @@ "not_equal": "diferit", "in": "în", "not_in": "nu în", - "less": "mai puţin", - "less_or_equal": "mai puţin sau egal", + "less": "mai mic", + "less_or_equal": "mai mic sau egal", "greater": "mai mare", "greater_or_equal": "mai mare sau egal", + "between": "între", + "not_between": "nu între", "begins_with": "începe cu", "not_begins_with": "nu începe cu", "contains": "conţine", @@ -30,5 +33,31 @@ "is_not_empty": "nu este gol", "is_null": "e nul", "is_not_null": "nu e nul" + }, + + "errors": { + "no_filter": "Nici un filtru selectat", + "empty_group": "Grupul este gol", + "radio_empty": "Nici o valoare nu este selectată", + "checkbox_empty": "Nici o valoare nu este selectată", + "select_empty": "Nici o valoare nu este selectată", + "string_empty": "Valoare goală", + "string_exceed_min_length": "Trebuie să conţină mai puţin de {0} caractere", + "string_exceed_max_length": "Trebuie să conţină mai mult de {0} caractere", + "string_invalid_format": "Format invalid ({0})", + "number_nan": "Nu este număr", + "number_not_integer": "Nu este număr întreg", + "number_not_double": "Nu este număr real", + "number_exceed_min": "Trebuie să fie mai mare decât {0}", + "number_exceed_max": "Trebuie să fie mai mic decât {0}", + "number_wrong_step": "Trebuie să fie multiplu de {0}", + "number_between_invalid": "Valori invalide, {0} este mai mare decât {1}", + "datetime_empty": "Valoare goală", + "datetime_invalid": "Format dată invalid ({0})", + "datetime_exceed_min": "Trebuie să fie după {0}", + "datetime_exceed_max": "Trebuie să fie înainte {0}", + "datetime_between_invalid": "Valori invalide, {0} este mai mare decât {1}", + "boolean_not_valid": "Nu este boolean", + "operator_not_multiple": "Operatorul \"{1}\" nu poate accepta mai multe valori" } -} \ No newline at end of file +} diff --git a/src/i18n/ru.json b/src/i18n/ru.json index bfb180a7..9ccfefcc 100644 --- a/src/i18n/ru.json +++ b/src/i18n/ru.json @@ -1,5 +1,5 @@ { - "__copyright": "Локализационный файл", + "__locale": "Russian (ru)", "add_rule": "Добавить", "add_group": "Добавить группу", @@ -21,6 +21,7 @@ "greater": "больше", "greater_or_equal": "больше или равно", "between": "между", + "not_between": "не между", "begins_with": "начинается с", "not_begins_with": "не начинается с", "contains": "содержит", @@ -36,10 +37,10 @@ "errors": { "no_filter": "Фильтр не выбран", "empty_group": "Группа пуста", - "radio_empty": "Не выбранно значение", - "checkbox_empty": "Не выбранно значение", - "select_empty": "Не выбранно значение", - "string_empty": "Не заполненно", + "radio_empty": "Не выбрано значение", + "checkbox_empty": "Не выбрано значение", + "select_empty": "Не выбрано значение", + "string_empty": "Не заполнено", "string_exceed_min_length": "Должен содержать больше {0} символов", "string_exceed_max_length": "Должен содержать меньше {0} символов", "string_invalid_format": "Неверный формат ({0})", @@ -49,11 +50,13 @@ "number_exceed_min": "Должно быть больше {0}", "number_exceed_max": "Должно быть меньше, чем {0}", "number_wrong_step": "Должно быть кратно {0}", - "datetime_empty": "Не заполненно", + "number_between_invalid": "Недопустимые значения, {0} больше {1}", + "datetime_empty": "Не заполнено", "datetime_invalid": "Неверный формат даты ({0})", "datetime_exceed_min": "Должно быть, после {0}", "datetime_exceed_max": "Должно быть, до {0}", + "datetime_between_invalid": "Недопустимые значения, {0} больше {1}", "boolean_not_valid": "Не логическое", - "operator_not_multiple": "Оператор {0} не поддерживает много значений" + "operator_not_multiple": "Оператор \"{1}\" не поддерживает много значений" } } \ No newline at end of file diff --git a/src/i18n/sk.json b/src/i18n/sk.json new file mode 100644 index 00000000..0a5926c4 --- /dev/null +++ b/src/i18n/sk.json @@ -0,0 +1,63 @@ +{ + "__locale": "Slovensky (sk)", + "__author": "k2s", + + "add_rule": "Pridať podmienku", + "add_group": "Pridať skupinu", + "delete_rule": "Zmazať", + "delete_group": "Zmazať", + + "conditions": { + "AND": "A", + "OR": "ALEBO" + }, + + "operators": { + "equal": "rovné", + "not_equal": "nerovné", + "in": "v", + "not_in": "nie v", + "less": "menej", + "less_or_equal": "menej alebo rovné", + "greater": "väčšie", + "greater_or_equal": "väčšie alebo rovné", + "between": "medzi", + "not_between": "nie medzi", + "begins_with": "začína na", + "not_begins_with": "nezačína na", + "contains": "obsahuje", + "not_contains": "neobsahuje", + "ends_with": "končí na", + "not_ends_with": "nekončí na", + "is_empty": "je prázdne", + "is_not_empty": "nie je prázdne", + "is_null": "je null", + "is_not_null": "nie je null" + }, + + "errors": { + "no_filter": "Nie je zvolený filter", + "empty_group": "Skupina je prázdna", + "radio_empty": "Nie je označená hodnota", + "checkbox_empty": "Nie je označená hodnota", + "select_empty": "Nie je označená hodnota", + "string_empty": "Prázdna hodnota", + "string_exceed_min_length": "Musí obsahovať aspon {0} znakov", + "string_exceed_max_length": "Nesmie obsahovať viac ako {0} znakov", + "string_invalid_format": "Chybný formát ({0})", + "number_nan": "Nie je číslo", + "number_not_integer": "Nie je celé číslo", + "number_not_double": "Nie je desatinné číslo", + "number_exceed_min": "Musí byť väčšie ako {0}", + "number_exceed_max": "Musí byť menšie ako {0}", + "number_wrong_step": "Musí byť násobkom čísla {0}", + "number_between_invalid": "Chybné hodnoty, {0} je väčšie ako {1}", + "datetime_empty": "Prázdna hodnota", + "datetime_invalid": "Chybný formát dátumu ({0})", + "datetime_exceed_min": "Musí byť neskôr ako {0}", + "datetime_exceed_max": "Musí byť skôr ako {0}", + "datetime_between_invalid": "Chybné hodnoty, {0} je neskôr ako {1}", + "boolean_not_valid": "Neplatné áno/nie", + "operator_not_multiple": "Operátor '{1}' nepodporuje viacero hodnôt" + } +} diff --git a/src/i18n/sq.json b/src/i18n/sq.json new file mode 100644 index 00000000..415244bd --- /dev/null +++ b/src/i18n/sq.json @@ -0,0 +1,60 @@ +{ + "__locale": "Albanian (sq)", + "__author": "Tomor Pupovci", + + "add_rule": "Shto rregull", + "add_group": "Shto grup", + "delete_rule": "Fshij", + "delete_group": "Fshij", + + "conditions": { + "AND": "DHE", + "OR": "OSE" + }, + + "operators": { + "equal": "barabartë", + "not_equal": "e ndryshme prej", + "in": "në", + "not_in": "jo në", + "less": "më e vogël", + "less_or_equal": "më e vogël ose e barabartë me", + "greater": "më e madhe", + "greater_or_equal": "më e madhe ose e barabartë", + "between": "në mes", + "begins_with": "fillon me", + "not_begins_with": "nuk fillon me", + "contains": "përmban", + "not_contains": "nuk përmban", + "ends_with": "mbaron me", + "not_ends_with": "nuk mbaron me", + "is_empty": "është e zbrazët", + "is_not_empty": "nuk është e zbrazët", + "is_null": "është null", + "is_not_null": "nuk është null" + }, + + "errors": { + "no_filter": "Nuk ka filter të zgjedhur", + "empty_group": "Grupi është i zbrazët", + "radio_empty": "Nuk ka vlerë të zgjedhur", + "checkbox_empty": "Nuk ka vlerë të zgjedhur", + "select_empty": "Nuk ka vlerë të zgjedhur", + "string_empty": "Vlerë e zbrazët", + "string_exceed_min_length": "Duhet të përmbajë së paku {0} karaktere", + "string_exceed_max_length": "Nuk duhet të përmbajë më shumë se {0} karaktere", + "string_invalid_format": "Format i pasaktë ({0})", + "number_nan": "Nuk është numër", + "number_not_integer": "Nuk është numër i plotë", + "number_not_double": "Nuk është numër me presje", + "number_exceed_min": "Duhet të jetë më i madh se {0}", + "number_exceed_max": "Duhet të jetë më i vogël se {0}", + "number_wrong_step": "Duhet të jetë shumëfish i {0}", + "datetime_empty": "Vlerë e zbrazët", + "datetime_invalid": "Format i pasaktë i datës ({0})", + "datetime_exceed_min": "Duhet të jetë pas {0}", + "datetime_exceed_max": "Duhet të jetë para {0}", + "boolean_not_valid": "Nuk është boolean", + "operator_not_multiple": "Operatori \"{1}\" nuk mund të pranojë vlera të shumëfishta" + } +} \ No newline at end of file diff --git a/src/i18n/sv.json b/src/i18n/sv.json new file mode 100644 index 00000000..a3b06e84 --- /dev/null +++ b/src/i18n/sv.json @@ -0,0 +1,63 @@ +{ + "__locale": "Svenska (sv)", + "__author": "hekin1", + + "add_rule": "Lägg till regel", + "add_group": "Lägg till grupp", + "delete_rule": "Ta bort", + "delete_group": "Ta bort", + + "conditions": { + "AND": "OCH", + "OR": "ELLER" + }, + + "operators": { + "equal": "lika med", + "not_equal": "ej lika med", + "in": "en av", + "not_in": "ej en av", + "less": "mindre", + "less_or_equal": "mindre eller lika med", + "greater": "större", + "greater_or_equal": "större eller lika med", + "between": "mellan", + "not_between": "ej mellan", + "begins_with": "börjar med", + "not_begins_with": "börjar inte med", + "contains": "innehåller", + "not_contains": "innehåller inte", + "ends_with": "slutar med", + "not_ends_with": "slutar inte med", + "is_empty": "är tom", + "is_not_empty": "är inte tom", + "is_null": "är null", + "is_not_null": "är inte null" + }, + + "errors": { + "no_filter": "Inget filter valt", + "empty_group": "Gruppen är tom", + "radio_empty": "Inget värde valt", + "checkbox_empty": "Inget värde valt", + "select_empty": "Inget värde valt", + "string_empty": "Tomt värde", + "string_exceed_min_length": "Måste innehålla minst {0} tecken", + "string_exceed_max_length": "Får ej innehålla fler än {0} tecken", + "string_invalid_format": "Felaktigt format ({0})", + "number_nan": "Inte numeriskt", + "number_not_integer": "Inte en siffra", + "number_not_double": "Inte ett decimaltal", + "number_exceed_min": "Måste vara större än {0}", + "number_exceed_max": "Måste vara lägre än {0}", + "number_wrong_step": "Måste vara en mutipel av {0}", + "number_between_invalid": "Felaktiga värden, {0} är större än {1}", + "datetime_empty": "Tomt värde", + "datetime_invalid": "Felaktigt datumformat ({0})", + "datetime_exceed_min": "Måste vara efter {0}", + "datetime_exceed_max": "Måste vara före {0}", + "datetime_between_invalid": "Felaktiga värden, {0} är större än {1}", + "boolean_not_valid": "Inte en boolean", + "operator_not_multiple": "Operatorn \"{1}\" accepterar inte flera värden" + } +} diff --git a/src/i18n/sw.json b/src/i18n/sw.json new file mode 100644 index 00000000..e215a84f --- /dev/null +++ b/src/i18n/sw.json @@ -0,0 +1,63 @@ +{ + "__locale": "Swahili (sw)", + "__author": "Timothy Anyona", + + "add_rule": "Ongeza kanuni", + "add_group": "Ongeza kikundi", + "delete_rule": "Futa", + "delete_group": "Futa", + + "conditions": { + "AND": "NA", + "OR": "AU" + }, + + "operators": { + "equal": "ni", + "not_equal": "sio", + "in": "mojawapo ya", + "not_in": "sio mojawapo ya", + "less": "isiyozidi", + "less_or_equal": "isiyozidi au ni sawa na", + "greater": "inayozidi", + "greater_or_equal": "inayozidi au ni sawa na", + "between": "kati ya", + "not_between": "isiyo kati ya", + "begins_with": "inaanza na", + "not_begins_with": "isiyoanza na", + "contains": "ina", + "not_contains": "haina", + "ends_with": "inaisha na", + "not_ends_with": "isiyoisha na", + "is_empty": "ni tupu", + "is_not_empty": "sio tupu", + "is_null": "ni batili", + "is_not_null": "sio batili" + }, + + "errors": { + "no_filter": "Chujio halijachaguliwa", + "empty_group": "Kikundi ki tupu", + "radio_empty": "Thamani haijachaguliwa", + "checkbox_empty": "Thamani haijachaguliwa", + "select_empty": "Thamani haijachaguliwa", + "string_empty": "Thamani tupu", + "string_exceed_min_length": "Lazima iwe na vibambo visiopungua {0}", + "string_exceed_max_length": "Haifai kuwa na vibambo zaidi ya {0}", + "string_invalid_format": "Fomati batili ({0})", + "number_nan": "Sio nambari", + "number_not_integer": "Sio namba kamili", + "number_not_double": "Sio namba desimali", + "number_exceed_min": "Lazima iwe zaidi ya {0}", + "number_exceed_max": "Lazima iwe chini ya {0}", + "number_wrong_step": "Lazima iwe kigawe cha {0}", + "number_between_invalid": "Thamani batili, {0} ni kubwa kuliko {1}", + "datetime_empty": "Thamani tupu", + "datetime_invalid": "Fomati tarehe batili ({0})", + "datetime_exceed_min": "Lazima iwe baada ya {0}", + "datetime_exceed_max": "Lazima iwe kabla ya {0}", + "datetime_between_invalid": "Thamani batili, {0} ni baada ya {1}", + "boolean_not_valid": "Sio buleani", + "operator_not_multiple": "Opereta \"{1}\" haikubali thamani nyingi" + } +} diff --git a/src/i18n/tr.json b/src/i18n/tr.json new file mode 100644 index 00000000..25ecbf78 --- /dev/null +++ b/src/i18n/tr.json @@ -0,0 +1,63 @@ +{ + "__locale": "Turkish (tr)", + "__author": "Aykut Alpgiray Ateş", + + "add_rule": "Kural Ekle", + "add_group": "Grup Ekle", + "delete_rule": "Sil", + "delete_group": "Sil", + + "conditions": { + "AND": "Ve", + "OR": "Veya" + }, + + "operators": { + "equal": "eşit", + "not_equal": "eşit değil", + "in": "içinde", + "not_in": "içinde değil", + "less": "küçük", + "less_or_equal": "küçük veya eşit", + "greater": "büyük", + "greater_or_equal": "büyük veya eşit", + "between": "arasında", + "not_between": "arasında değil", + "begins_with": "ile başlayan", + "not_begins_with": "ile başlamayan", + "contains": "içeren", + "not_contains": "içermeyen", + "ends_with": "ile biten", + "not_ends_with": "ile bitmeyen", + "is_empty": "boş ise", + "is_not_empty": "boş değil ise", + "is_null": "var ise", + "is_not_null": "yok ise" + }, + + "errors": { + "no_filter": "Bir filtre seçili değil", + "empty_group": "Grup bir eleman içermiyor", + "radio_empty": "Seçim yapılmalı", + "checkbox_empty": "Seçim yapılmalı", + "select_empty": "Seçim yapılmalı", + "string_empty": "Bir metin girilmeli", + "string_exceed_min_length": "En az {0} karakter girilmeli", + "string_exceed_max_length": "En fazla {0} karakter girilebilir", + "string_invalid_format": "Uyumsuz format ({0})", + "number_nan": "Sayı değil", + "number_not_integer": "Tam sayı değil", + "number_not_double": "Ondalıklı sayı değil", + "number_exceed_min": "Sayı {0}'den/dan daha büyük olmalı", + "number_exceed_max": "Sayı {0}'den/dan daha küçük olmalı", + "number_wrong_step": "{0} veya katı olmalı", + "number_between_invalid": "Geçersiz değerler, {0} değeri {1} değerinden büyük", + "datetime_empty": "Tarih Seçilmemiş", + "datetime_invalid": "Uygun olmayan tarih formatı ({0})", + "datetime_exceed_min": "{0} Tarihinden daha sonrası olmalı.", + "datetime_exceed_max": "{0} Tarihinden daha öncesi olmalı.", + "datetime_between_invalid": "Geçersiz değerler, {0} değeri {1} değerinden büyük", + "boolean_not_valid": "Değer Doğru/Yanlış(bool) olmalı", + "operator_not_multiple": "Operatör \"{1}\" birden fazla değer kabul etmiyor" + } +} diff --git a/src/i18n/ua.json b/src/i18n/ua.json new file mode 100644 index 00000000..2d1c5c2d --- /dev/null +++ b/src/i18n/ua.json @@ -0,0 +1,57 @@ +{ + "__locale": "Ukrainian (ua)", + "__author": "Megaplan, mborisv ", + + "add_rule": "Додати", + "add_group": "Додати групу", + "delete_rule": "Видалити", + "delete_group": "Видалити", + "conditions": { + "AND": "І", + "OR": "АБО" + }, + "operators": { + "equal": "дорівнює", + "not_equal": "не дорівнює", + "in": "з вказаних", + "not_in": "не з вказаних", + "less": "менше", + "less_or_equal": "менше або дорівнюж", + "greater": "більше", + "greater_or_equal": "більше або дорівнює", + "between": "між", + "begins_with": "починається з", + "not_begins_with": "не починається з", + "contains": "містить", + "not_contains": "не містить", + "ends_with": "закінчується на", + "not_ends_with": "не не закінчується на", + "is_empty": "порожній рядок", + "is_not_empty": "не порожній рядок", + "is_null": "порожньо", + "is_not_null": "не порожньо" + }, + "errors": { + "no_filter": "Фільтр не вибраний", + "empty_group": "Група порожня", + "radio_empty": "Значення не вибрано", + "checkbox_empty": "Значення не вибрано", + "select_empty": "Значення не вибрано", + "string_empty": "Не заповнено", + "string_exceed_min_length": "Повинен містити більше {0} символів", + "string_exceed_max_length": "Повинен містити менше {0} символів", + "string_invalid_format": "Невірний формат ({0})", + "number_nan": "Не число", + "number_not_integer": "Не число", + "number_not_double": "Не число", + "number_exceed_min": "Повинне бути більше {0}", + "number_exceed_max": "Повинне бути менше, ніж {0}", + "number_wrong_step": "Повинне бути кратне {0}", + "datetime_empty": "Не заповнено", + "datetime_invalid": "Невірний формат дати ({0})", + "datetime_exceed_min": "Повинне бути, після {0}", + "datetime_exceed_max": "Повинне бути, до {0}", + "boolean_not_valid": "Не логічне", + "operator_not_multiple": "Оператор \"{1}\" не підтримує багато значень" + } +} \ No newline at end of file diff --git a/src/i18n/zh-CN.json b/src/i18n/zh-CN.json new file mode 100644 index 00000000..666ca685 --- /dev/null +++ b/src/i18n/zh-CN.json @@ -0,0 +1,61 @@ +{ + "__locale": "Simplified Chinese (zh_CN)", + "__author": "shadowwind, shatteredwindgo@gmail.com", + + "add_rule": "添加规则", + "add_group": "添加组", + "delete_rule": "删除", + "delete_group": "删除组", + + "conditions": { + "AND": "和", + "OR": "或" + }, + + "operators": { + "equal": "等于", + "not_equal": "不等于", + "in": "在...之內", + "not_in": "不在...之內", + "less": "小于", + "less_or_equal": "小于或等于", + "greater": "大于", + "greater_or_equal": "大于或等于", + "between": "在...之间", + "not_between": "不在...之间", + "begins_with": "以...开始", + "not_begins_with": "不以...开始", + "contains": "包含以下内容", + "not_contains": "不包含以下内容", + "ends_with": "以...结束", + "not_ends_with": "不以...结束", + "is_empty": "为空", + "is_not_empty": "不为空", + "is_null": "为 null", + "is_not_null": "不为 null" + }, + + "errors": { + "no_filter": "没有选择过滤器", + "empty_group": "该组为空", + "radio_empty": "没有选中项", + "checkbox_empty": "没有选中项", + "select_empty": "没有选中项", + "string_empty": "没有输入值", + "string_exceed_min_length": "必须至少包含{0}个字符", + "string_exceed_max_length": "必须不超过{0}个字符", + "string_invalid_format": "无效格式({0})", + "number_nan": "值不是数字", + "number_not_integer": "不是整数", + "number_not_double": "不是浮点数", + "number_exceed_min": "必须大于{0}", + "number_exceed_max": "必须小于{0}", + "number_wrong_step": "必须是{0}的倍数", + "datetime_empty": "值为空", + "datetime_invalid": "不是有效日期({0})", + "datetime_exceed_min": "必须在{0}之后", + "datetime_exceed_max": "必须在{0}之前", + "boolean_not_valid": "不是布尔值", + "operator_not_multiple": "选项\"{1}\"无法接受多个值" + } +} \ No newline at end of file diff --git a/src/jquery.js b/src/jquery.js index caa0e108..941ea675 100644 --- a/src/jquery.js +++ b/src/jquery.js @@ -1,16 +1,38 @@ +/** + * The {@link http://learn.jquery.com/plugins/|jQuery Plugins} namespace + * @external "jQuery.fn" + */ + +/** + * Instanciates or accesses the {@link QueryBuilder} on an element + * @function + * @memberof external:"jQuery.fn" + * @param {*} option - initial configuration or method name + * @param {...*} args - method arguments + * + * @example + * $('#builder').queryBuilder({ /** configuration object *\/ }); + * @example + * $('#builder').queryBuilder('methodName', methodParam1, methodParam2); + */ $.fn.queryBuilder = function(option) { + if (this.length === 0) { + Utils.error('Config', 'No target defined'); + } if (this.length > 1) { - error('Unable to initialize on multiple target'); + Utils.error('Config', 'Unable to initialize on multiple target'); } - var data = this.data('queryBuilder'), - options = (typeof option == 'object' && option) || {}; + var data = this.data('queryBuilder'); + var options = (typeof option == 'object' && option) || {}; if (!data && option == 'destroy') { return this; } if (!data) { - this.data('queryBuilder', new QueryBuilder(this, options)); + var builder = new QueryBuilder(this, options); + this.data('queryBuilder', builder); + builder.init(options.rules); } if (typeof option == 'string') { return data[option].apply(data, Array.prototype.slice.call(arguments, 1)); @@ -19,7 +41,37 @@ $.fn.queryBuilder = function(option) { return this; }; +/** + * @function + * @memberof external:"jQuery.fn" + * @see QueryBuilder + */ $.fn.queryBuilder.constructor = QueryBuilder; + +/** + * @function + * @memberof external:"jQuery.fn" + * @see QueryBuilder.defaults + */ $.fn.queryBuilder.defaults = QueryBuilder.defaults; + +/** + * @function + * @memberof external:"jQuery.fn" + * @see QueryBuilder.defaults + */ $.fn.queryBuilder.extend = QueryBuilder.extend; -$.fn.queryBuilder.define = QueryBuilder.define; \ No newline at end of file + +/** + * @function + * @memberof external:"jQuery.fn" + * @see QueryBuilder.define + */ +$.fn.queryBuilder.define = QueryBuilder.define; + +/** + * @function + * @memberof external:"jQuery.fn" + * @see QueryBuilder.regional + */ +$.fn.queryBuilder.regional = QueryBuilder.regional; diff --git a/src/main.js b/src/main.js index 4e6faf44..0659d288 100644 --- a/src/main.js +++ b/src/main.js @@ -1,127 +1,223 @@ -// CLASS DEFINITION -// =============================== +/** + * @typedef {object} Filter + * @memberof QueryBuilder + * @description See {@link http://querybuilder.js.org/index.html#filters} + */ + +/** + * @typedef {object} Operator + * @memberof QueryBuilder + * @description See {@link http://querybuilder.js.org/index.html#operators} + */ + +/** + * @param {jQuery} $el + * @param {object} options - see {@link http://querybuilder.js.org/#options} + * @constructor + */ var QueryBuilder = function($el, options) { - this.init($el, options); -}; + $el[0].queryBuilder = this; + + /** + * Element container + * @member {jQuery} + * @readonly + */ + this.$el = $el; + + /** + * Configuration object + * @member {object} + * @readonly + */ + this.settings = $.extendext(true, 'replace', {}, QueryBuilder.DEFAULTS, options); + + /** + * Internal model + * @member {Model} + * @readonly + */ + this.model = new Model(); + + /** + * Internal status + * @member {object} + * @property {string} id - id of the container + * @property {boolean} generated_id - if the container id has been generated + * @property {int} group_id - current group id + * @property {int} rule_id - current rule id + * @property {boolean} has_optgroup - if filters have optgroups + * @property {boolean} has_operator_optgroup - if operators have optgroups + * @readonly + * @private + */ + this.status = { + id: null, + generated_id: false, + group_id: 0, + rule_id: 0, + has_optgroup: false, + has_operator_optgroup: false + }; + /** + * List of filters + * @member {QueryBuilder.Filter[]} + * @readonly + */ + this.filters = this.settings.filters; + + /** + * List of icons + * @member {object.} + * @readonly + */ + this.icons = this.settings.icons; + + /** + * List of operators + * @member {QueryBuilder.Operator[]} + * @readonly + */ + this.operators = this.settings.operators; + + /** + * List of templates + * @member {object.} + * @readonly + */ + this.templates = this.settings.templates; + + /** + * Plugins configuration + * @member {object.} + * @readonly + */ + this.plugins = this.settings.plugins; + + /** + * Translations object + * @member {object} + * @readonly + */ + this.lang = null; + + // translations : english << 'lang_code' << custom + if (QueryBuilder.regional['en'] === undefined) { + Utils.error('Config', '"i18n/en.js" not loaded.'); + } + this.lang = $.extendext(true, 'replace', {}, QueryBuilder.regional['en'], QueryBuilder.regional[this.settings.lang_code], this.settings.lang); -// EVENTS SYSTEM -// =============================== -var aps = Array.prototype.slice; + // "allow_groups" can be boolean or int + if (this.settings.allow_groups === false) { + this.settings.allow_groups = 0; + } + else if (this.settings.allow_groups === true) { + this.settings.allow_groups = -1; + } -$.extend(QueryBuilder.prototype, { - change: function(type, value) { - var event = new $.Event(type + '.queryBuilder.filter', { - builder: this, - value: value - }); + // init templates + Object.keys(this.templates).forEach(function(tpl) { + if (!this.templates[tpl]) { + this.templates[tpl] = QueryBuilder.templates[tpl]; + } + if (typeof this.templates[tpl] !== 'function') { + throw new Error(`Template ${tpl} must be a function`); + } + }, this); - this.$el.triggerHandler(event, aps.call(arguments, 2)); + // ensure we have a container id + if (!this.$el.attr('id')) { + this.$el.attr('id', 'qb_' + Math.floor(Math.random() * 99999)); + this.status.generated_id = true; + } + this.status.id = this.$el.attr('id'); - return event.value; - }, + // INIT + this.$el.addClass('query-builder'); + + this.filters = this.checkFilters(this.filters); + this.operators = this.checkOperators(this.operators); + this.bindEvents(); + this.initPlugins(); +}; +$.extend(QueryBuilder.prototype, /** @lends QueryBuilder.prototype */ { + /** + * Triggers an event on the builder container + * @param {string} type + * @returns {$.Event} + */ trigger: function(type) { - var event = new $.Event(type + '.queryBuilder', { + var event = new $.Event(this._tojQueryEvent(type), { builder: this }); - this.$el.triggerHandler(event, aps.call(arguments, 1)); + this.$el.triggerHandler(event, Array.prototype.slice.call(arguments, 1)); return event; }, + /** + * Triggers an event on the builder container and returns the modified value + * @param {string} type + * @param {*} value + * @returns {*} + */ + change: function(type, value) { + var event = new $.Event(this._tojQueryEvent(type, true), { + builder: this, + value: value + }); + + this.$el.triggerHandler(event, Array.prototype.slice.call(arguments, 2)); + + return event.value; + }, + + /** + * Attaches an event listener on the builder container + * @param {string} type + * @param {function} cb + * @returns {QueryBuilder} + */ on: function(type, cb) { - this.$el.on(type + '.queryBuilder', cb); + this.$el.on(this._tojQueryEvent(type), cb); return this; }, + /** + * Removes an event listener from the builder container + * @param {string} type + * @param {function} [cb] + * @returns {QueryBuilder} + */ off: function(type, cb) { - this.$el.off(type + '.queryBuilder', cb); + this.$el.off(this._tojQueryEvent(type), cb); return this; }, + /** + * Attaches an event listener called once on the builder container + * @param {string} type + * @param {function} cb + * @returns {QueryBuilder} + */ once: function(type, cb) { - this.$el.one(type + '.queryBuilder', cb); + this.$el.one(this._tojQueryEvent(type), cb); return this; - } -}); - - -// PLUGINS SYSTEM -// =============================== -QueryBuilder.plugins = {}; - -/** - * Get or extend the default configuration - * @param options {object,optional} new configuration, leave undefined to get the default config - * @return {undefined|object} nothing or configuration object (copy) - */ -QueryBuilder.defaults = function(options) { - if (typeof options == 'object') { - $.extendext(true, 'replace', QueryBuilder.DEFAULTS, options); - } - else if (typeof options == 'string') { - if (typeof QueryBuilder.DEFAULTS[options] == 'object') { - return $.extend(true, {}, QueryBuilder.DEFAULTS[options]); - } - else { - return QueryBuilder.DEFAULTS[options]; - } - } - else { - return $.extend(true, {}, QueryBuilder.DEFAULTS); - } -}; - -/** - * Define a new plugin - * @param {string} - * @param {function} - * @param {object,optional} default configuration - */ -QueryBuilder.define = function(name, fct, def) { - QueryBuilder.plugins[name] = { - fct: fct, - def: def || {} - }; -}; - -/** - * Add new methods - * @param {object} - */ -QueryBuilder.extend = function(methods) { - $.extend(QueryBuilder.prototype, methods); -}; - -/** - * Init plugins for an instance - */ -QueryBuilder.prototype.initPlugins = function() { - if (!this.plugins) { - return; - } + }, - if ($.isArray(this.plugins)) { - var tmp = {}; - this.plugins.forEach(function(plugin) { - tmp[plugin] = null; - }); - this.plugins = tmp; + /** + * Appends `.queryBuilder` and optionally `.filter` to the events names + * @param {string} name + * @param {boolean} [filter=false] + * @returns {string} + * @private + */ + _tojQueryEvent: function(name, filter) { + return name.split(' ').map(function(type) { + return type + '.queryBuilder' + (filter ? '.filter' : ''); + }).join(' '); } - - Object.keys(this.plugins).forEach(function(plugin) { - if (plugin in QueryBuilder.plugins) { - this.plugins[plugin] = $.extend(true, {}, - QueryBuilder.plugins[plugin].def, - this.plugins[plugin] || {} - ); - - QueryBuilder.plugins[plugin].fct.call(this, this.plugins[plugin]); - } - else { - error('Unable to find plugin "{0}"', plugin); - } - }, this); -}; \ No newline at end of file +}); diff --git a/src/model.js b/src/model.js index c50dc9d3..a397c98f 100644 --- a/src/model.js +++ b/src/model.js @@ -1,112 +1,145 @@ -// Model CLASS -// =============================== /** - * Main object storing data model and emitting events - * --------- - * Access Node object stored in jQuery objects - * @param el {jQuery|Node} - * @return {Node} + * Main object storing data model and emitting model events + * @constructor */ -function Model(el) { - if (!(this instanceof Model)) { - return Model.getModel(el); - } - +function Model() { + /** + * @member {Group} + * @readonly + */ this.root = null; + + /** + * Base for event emitting + * @member {jQuery} + * @readonly + * @private + */ this.$ = $(this); } -$.extend(Model.prototype, { +$.extend(Model.prototype, /** @lends Model.prototype */ { + /** + * Triggers an event on the model + * @param {string} type + * @returns {$.Event} + */ trigger: function(type) { - this.$.triggerHandler(type, aps.call(arguments, 1)); - return this; + var event = new $.Event(type); + this.$.triggerHandler(event, Array.prototype.slice.call(arguments, 1)); + return event; }, + /** + * Attaches an event listener on the model + * @param {string} type + * @param {function} cb + * @returns {Model} + */ on: function() { - this.$.on.apply(this.$, aps.call(arguments)); + this.$.on.apply(this.$, Array.prototype.slice.call(arguments)); return this; }, + /** + * Removes an event listener from the model + * @param {string} type + * @param {function} [cb] + * @returns {Model} + */ off: function() { - this.$.off.apply(this.$, aps.call(arguments)); + this.$.off.apply(this.$, Array.prototype.slice.call(arguments)); return this; }, + /** + * Attaches an event listener called once on the model + * @param {string} type + * @param {function} cb + * @returns {Model} + */ once: function() { - this.$.one.apply(this.$, aps.call(arguments)); + this.$.one.apply(this.$, Array.prototype.slice.call(arguments)); return this; } }); -/** - * Access Node object stored in jQuery objects - * @param el {jQuery|Node} - * @return {Node} - */ -Model.getModel = function(el) { - if (!el) { - return null; - } - else if (el instanceof Node) { - return el; - } - else { - return $(el).data('queryBuilderModel'); - } -}; - -/* - * Define Node properties with getter and setter - * Update events are emitted in the setter through root Model (if any) - */ -function defineModelProperties(obj, fields) { - fields.forEach(function(field) { - Object.defineProperty(obj.prototype, field, { - enumerable: true, - get: function() { - return this.__[field]; - }, - set: function(value) { - var oldValue = (this.__[field] !== null && typeof this.__[field] == 'object') ? - $.extend({}, this.__[field]) : - this.__[field]; - - this.__[field] = value; - - if (this.model !== null) { - this.model.trigger('update', this, field, value, oldValue); - } - } - }); - }); -} - -// Node abstract CLASS -// =============================== /** - * @param {Node} - * @param {jQuery} + * Root abstract object + * @constructor + * @param {Node} [parent] + * @param {jQuery} $el */ var Node = function(parent, $el) { if (!(this instanceof Node)) { - return new Node(); + return new Node(parent, $el); } - Object.defineProperty(this, '__', { value: {}}); + Object.defineProperty(this, '__', { value: {} }); $el.data('queryBuilderModel', this); - this.model = parent === null ? null : parent.model; - this.parent = parent; - // this.level -- initialized in 'parent' setter + /** + * @name level + * @member {int} + * @memberof Node + * @instance + * @readonly + */ + this.__.level = 1; + + /** + * @name error + * @member {string} + * @memberof Node + * @instance + */ + this.__.error = null; + + /** + * @name flags + * @member {object} + * @memberof Node + * @instance + * @readonly + */ + this.__.flags = {}; + + /** + * @name data + * @member {object} + * @memberof Node + * @instance + */ + this.__.data = undefined; + + /** + * @member {jQuery} + * @readonly + */ this.$el = $el; + + /** + * @member {string} + * @readonly + */ this.id = $el[0].id; - this.error = null; - this.data = undefined; + + /** + * @member {Model} + * @readonly + */ + this.model = null; + + /** + * @member {Group} + * @readonly + */ + this.parent = parent; }; -defineModelProperties(Node, ['level', 'error', 'data']); +Utils.defineModelProperties(Node, ['level', 'error', 'data', 'flags']); Object.defineProperty(Node.prototype, 'parent', { enumerable: true, @@ -115,21 +148,22 @@ Object.defineProperty(Node.prototype, 'parent', { }, set: function(value) { this.__.parent = value; - this.level = this.parent === null ? 1 : this.parent.level+1; + this.level = value === null ? 1 : value.level + 1; + this.model = value === null ? null : value.model; } }); /** - * Check if this Node is the root - * @return {boolean} + * Checks if this Node is the root + * @returns {boolean} */ Node.prototype.isRoot = function() { return (this.level === 1); }; /** - * Return node position inside parent - * @return {int} + * Returns the node position inside its parent + * @returns {int} */ Node.prototype.getPos = function() { if (this.isRoot()) { @@ -141,72 +175,107 @@ Node.prototype.getPos = function() { }; /** - * Delete self + * Deletes self + * @fires Model.model:drop */ Node.prototype.drop = function() { - if (this.model !== null) { - this.model.trigger('drop', this); + var model = this.model; + + if (!!this.parent) { + this.parent.removeNode(this); } - if (!this.isRoot()) { - this.parent._dropNode(this); - this.parent = null; + this.$el.removeData('queryBuilderModel'); + + if (model !== null) { + /** + * After a node of the model has been removed + * @event model:drop + * @memberof Model + * @param {Node} node + */ + model.trigger('drop', this); } }; /** - * Move itself after another Node - * @param {Node} - * @return {Node} self + * Moves itself after another Node + * @param {Node} target + * @fires Model.model:move */ -Node.prototype.moveAfter = function(node) { - if (this.isRoot()) return; - - this.parent._dropNode(this); - node.parent._addNode(this, node.getPos()+1); - return this; +Node.prototype.moveAfter = function(target) { + if (!this.isRoot()) { + this.move(target.parent, target.getPos() + 1); + } }; /** - * Move itself at the beginning of parent or another Group - * @param {Group,optional} - * @return {Node} self + * Moves itself at the beginning of parent or another Group + * @param {Group} [target] + * @fires Model.model:move */ Node.prototype.moveAtBegin = function(target) { - if (this.isRoot()) return; + if (!this.isRoot()) { + if (target === undefined) { + target = this.parent; + } - if (target === undefined) { - target = this.parent; + this.move(target, 0); } - - this.parent._dropNode(this); - target._addNode(this, 0); - return this; }; /** - * Move itself at the end of parent or another Group - * @param {Group,optional} - * @return {Node} self + * Moves itself at the end of parent or another Group + * @param {Group} [target] + * @fires Model.model:move */ Node.prototype.moveAtEnd = function(target) { - if (this.isRoot()) return; + if (!this.isRoot()) { + if (target === undefined) { + target = this.parent; + } - if (target === undefined) { - target = this.parent; + this.move(target, target.length() === 0 ? 0 : target.length() - 1); } +}; - this.parent._dropNode(this); - target._addNode(this, target.length()); - return this; +/** + * Moves itself at specific position of Group + * @param {Group} target + * @param {int} index + * @fires Model.model:move + */ +Node.prototype.move = function(target, index) { + if (!this.isRoot()) { + if (typeof target === 'number') { + index = target; + target = this.parent; + } + + this.parent.removeNode(this); + target.insertNode(this, index, false); + + if (this.model !== null) { + /** + * After a node of the model has been moved + * @event model:move + * @memberof Model + * @param {Node} node + * @param {Node} target + * @param {int} index + */ + this.model.trigger('move', this, target, index); + } + } }; -// GROUP CLASS -// =============================== /** - * @param {Group} - * @param {jQuery} + * Group object + * @constructor + * @extends Node + * @param {Group} [parent] + * @param {jQuery} $el */ var Group = function(parent, $el) { if (!(this instanceof Group)) { @@ -215,17 +284,28 @@ var Group = function(parent, $el) { Node.call(this, parent, $el); - this.condition = null; + /** + * @member {object[]} + * @readonly + */ this.rules = []; + + /** + * @name condition + * @member {string} + * @memberof Group + * @instance + */ + this.__.condition = null; }; Group.prototype = Object.create(Node.prototype); Group.prototype.constructor = Group; -defineModelProperties(Group, ['condition']); +Utils.defineModelProperties(Group, ['condition']); /** - * Empty the Group + * Removes group's content */ Group.prototype.empty = function() { this.each('reverse', function(rule) { @@ -236,7 +316,7 @@ Group.prototype.empty = function() { }; /** - * Delete self + * Deletes self */ Group.prototype.drop = function() { this.empty(); @@ -244,20 +324,22 @@ Group.prototype.drop = function() { }; /** - * Return the number of children - * @return {int} + * Returns the number of children + * @returns {int} */ Group.prototype.length = function() { return this.rules.length; }; /** - * Add a Node at specified index - * @param {Node} - * @param {int,optional} - * @return {Node} the inserted node + * Adds a Node at specified index + * @param {Node} node + * @param {int} [index=end] + * @param {boolean} [trigger=false] - fire 'add' event + * @returns {Node} the inserted node + * @fires Model.model:add */ -Group.prototype._addNode = function(node, index) { +Group.prototype.insertNode = function(node, index, trigger) { if (index === undefined) { index = this.length(); } @@ -265,66 +347,80 @@ Group.prototype._addNode = function(node, index) { this.rules.splice(index, 0, node); node.parent = this; - if (this.model !== null) { - this.model.trigger('add', node, index); + if (trigger && this.model !== null) { + /** + * After a node of the model has been added + * @event model:add + * @memberof Model + * @param {Node} parent + * @param {Node} node + * @param {int} index + */ + this.model.trigger('add', this, node, index); } return node; }; /** - * Add a Group by jQuery element at specified index - * @param {jQuery} - * @param {int,optional} - * @return {Group} the inserted group + * Adds a new Group at specified index + * @param {jQuery} $el + * @param {int} [index=end] + * @returns {Group} + * @fires Model.model:add */ Group.prototype.addGroup = function($el, index) { - return this._addNode(new Group(this, $el), index); + return this.insertNode(new Group(this, $el), index, true); }; /** - * Add a Rule by jQuery element at specified index - * @param {jQuery} - * @param {int,optional} - * @return {Rule} the inserted rule + * Adds a new Rule at specified index + * @param {jQuery} $el + * @param {int} [index=end] + * @returns {Rule} + * @fires Model.model:add */ Group.prototype.addRule = function($el, index) { - return this._addNode(new Rule(this, $el), index); + return this.insertNode(new Rule(this, $el), index, true); }; /** - * Delete a specific Node - * @param {Node} - * @return {Group} self + * Deletes a specific Node + * @param {Node} node */ -Group.prototype._dropNode = function(node) { +Group.prototype.removeNode = function(node) { var index = this.getNodePos(node); if (index !== -1) { node.parent = null; this.rules.splice(index, 1); } - - return this; }; /** - * Return position of a child Node - * @param {Node} - * @return {int} + * Returns the position of a child Node + * @param {Node} node + * @returns {int} */ Group.prototype.getNodePos = function(node) { return this.rules.indexOf(node); }; +/** + * @callback Model#GroupIteratee + * @param {Node} node + * @returns {boolean} stop the iteration + */ + /** * Iterate over all Nodes - * @param {boolean,optional} iterate in reverse order, required if you delete nodes - * @param {function} callback for Rules - * @param {function,optional} callback for Groups - * @return {boolean} + * @param {boolean} [reverse=false] - iterate in reverse order, required if you delete nodes + * @param {Model#GroupIteratee} cbRule - callback for Rules (can be `null` but not omitted) + * @param {Model#GroupIteratee} [cbGroup] - callback for Groups + * @param {object} [context] - context for callbacks + * @returns {boolean} if the iteration has been stopped by a callback */ Group.prototype.each = function(reverse, cbRule, cbGroup, context) { - if (typeof reverse === 'function') { + if (typeof reverse !== 'boolean' && typeof reverse !== 'string') { context = cbGroup; cbGroup = cbRule; cbRule = reverse; @@ -332,19 +428,21 @@ Group.prototype.each = function(reverse, cbRule, cbGroup, context) { } context = context === undefined ? null : context; - var i = reverse ? this.rules.length-1 : 0, - l = reverse ? 0 : this.rules.length-1, - c = reverse ? -1 : 1, - next = function(){ return reverse ? i>=l : i<=l; }, - stop = false; + var i = reverse ? this.rules.length - 1 : 0; + var l = reverse ? 0 : this.rules.length - 1; + var c = reverse ? -1 : 1; + var next = function() { + return reverse ? i >= l : i <= l; + }; + var stop = false; - for (; next(); i+=c) { + for (; next(); i += c) { if (this.rules[i] instanceof Group) { - if (cbGroup !== undefined) { + if (!!cbGroup) { stop = cbGroup.call(context, this.rules[i]) === false; } } - else { + else if (!!cbRule) { stop = cbRule.call(context, this.rules[i]) === false; } @@ -357,21 +455,21 @@ Group.prototype.each = function(reverse, cbRule, cbGroup, context) { }; /** - * Return true if the group contains a particular Node - * @param {Node} - * @param {boolean,optional} recursive search - * @return {boolean} + * Checks if the group contains a particular Node + * @param {Node} node + * @param {boolean} [recursive=false] + * @returns {boolean} */ -Group.prototype.contains = function(node, deep) { +Group.prototype.contains = function(node, recursive) { if (this.getNodePos(node) !== -1) { return true; } - else if (!deep) { + else if (!recursive) { return false; } else { // the loop will return with false as soon as the Node is found - return !this.each(function(rule) { + return !this.each(function() { return true; }, function(group) { return !group.contains(node, true); @@ -380,11 +478,12 @@ Group.prototype.contains = function(node, deep) { }; -// RULE CLASS -// =============================== /** - * @param {Group} - * @param {jQuery} + * Rule object + * @constructor + * @extends Node + * @param {Group} parent + * @param {jQuery} $el */ var Rule = function(parent, $el) { if (!(this instanceof Rule)) { @@ -393,16 +492,58 @@ var Rule = function(parent, $el) { Node.call(this, parent, $el); - this.filter = null; - this.operator = null; - this.flags = {}; + this._updating_value = false; + this._updating_input = false; + + /** + * @name filter + * @member {QueryBuilder.Filter} + * @memberof Rule + * @instance + */ + this.__.filter = null; + + /** + * @name operator + * @member {QueryBuilder.Operator} + * @memberof Rule + * @instance + */ + this.__.operator = null; + + /** + * @name value + * @member {*} + * @memberof Rule + * @instance + */ + this.__.value = undefined; }; Rule.prototype = Object.create(Node.prototype); Rule.prototype.constructor = Rule; -defineModelProperties(Rule, ['filter', 'operator', 'flags']); +Utils.defineModelProperties(Rule, ['filter', 'operator', 'value']); + +/** + * Checks if this Node is the root + * @returns {boolean} always false + */ +Rule.prototype.isRoot = function() { + return false; +}; +/** + * @member {function} + * @memberof QueryBuilder + * @see Group + */ QueryBuilder.Group = Group; -QueryBuilder.Rule = Rule; \ No newline at end of file + +/** + * @member {function} + * @memberof QueryBuilder + * @see Rule + */ +QueryBuilder.Rule = Rule; diff --git a/src/plugins.js b/src/plugins.js new file mode 100644 index 00000000..036f9cc4 --- /dev/null +++ b/src/plugins.js @@ -0,0 +1,114 @@ +/** + * @module plugins + */ + +/** + * Definition of available plugins + * @type {object.} + */ +QueryBuilder.plugins = {}; + +/** + * Gets or extends the default configuration + * @param {object} [options] - new configuration + * @returns {undefined|object} nothing or configuration object (copy) + */ +QueryBuilder.defaults = function(options) { + if (typeof options == 'object') { + $.extendext(true, 'replace', QueryBuilder.DEFAULTS, options); + } + else if (typeof options == 'string') { + if (typeof QueryBuilder.DEFAULTS[options] == 'object') { + return $.extend(true, {}, QueryBuilder.DEFAULTS[options]); + } + else { + return QueryBuilder.DEFAULTS[options]; + } + } + else { + return $.extend(true, {}, QueryBuilder.DEFAULTS); + } +}; + +/** + * Registers a new plugin + * @param {string} name + * @param {function} fct - init function + * @param {object} [def] - default options + */ +QueryBuilder.define = function(name, fct, def) { + QueryBuilder.plugins[name] = { + fct: fct, + def: def || {} + }; +}; + +/** + * Adds new methods to QueryBuilder prototype + * @param {object.} methods + */ +QueryBuilder.extend = function(methods) { + $.extend(QueryBuilder.prototype, methods); +}; + +/** + * Initializes plugins for an instance + * @throws ConfigError + * @private + */ +QueryBuilder.prototype.initPlugins = function() { + if (!this.plugins) { + return; + } + + if ($.isArray(this.plugins)) { + var tmp = {}; + this.plugins.forEach(function(plugin) { + tmp[plugin] = null; + }); + this.plugins = tmp; + } + + Object.keys(this.plugins).forEach(function(plugin) { + if (plugin in QueryBuilder.plugins) { + this.plugins[plugin] = $.extend(true, {}, + QueryBuilder.plugins[plugin].def, + this.plugins[plugin] || {} + ); + + QueryBuilder.plugins[plugin].fct.call(this, this.plugins[plugin]); + } + else { + Utils.error('Config', 'Unable to find plugin "{0}"', plugin); + } + }, this); +}; + +/** + * Returns the config of a plugin, if the plugin is not loaded, returns the default config. + * @param {string} name + * @param {string} [property] + * @throws ConfigError + * @returns {*} + */ +QueryBuilder.prototype.getPluginOptions = function(name, property) { + var plugin; + if (this.plugins && this.plugins[name]) { + plugin = this.plugins[name]; + } + else if (QueryBuilder.plugins[name]) { + plugin = QueryBuilder.plugins[name].def; + } + + if (plugin) { + if (property) { + return plugin[property]; + } + else { + return plugin; + } + } + else { + Utils.error('Config', 'Unable to find plugin "{0}"', name); + } +}; diff --git a/src/plugins/bt-checkbox/plugin.js b/src/plugins/bt-checkbox/plugin.js index 45865306..26b0998f 100644 --- a/src/plugins/bt-checkbox/plugin.js +++ b/src/plugins/bt-checkbox/plugin.js @@ -1,25 +1,14 @@ -/*! - * jQuery QueryBuilder Awesome Bootstrap Checkbox - * Applies Awesome Bootstrap Checkbox for checkbox and radio inputs. - * Copyright 2014-2015 Damien "Mistic" Sorel (http://www.strangeplanet.fr) +/** + * @class BtCheckbox + * @memberof module:plugins + * @description Applies Awesome Bootstrap Checkbox for checkbox and radio inputs. + * @param {object} [options] + * @param {string} [options.font='bootstrap-icons'] + * @param {string} [options.color='default'] */ - -/*jshint multistr:true */ - QueryBuilder.define('bt-checkbox', function(options) { - if (options.font == 'glyphicons') { - var injectCSS = document.createElement('style'); - injectCSS.innerHTML = '\ -.checkbox input[type=checkbox]:checked + label:after { \ - font-family: "Glyphicons Halflings"; \ - content: "\\e013"; \ -} \ -.checkbox label:after { \ - padding-left: 4px; \ - padding-top: 2px; \ - font-size: 9px; \ -}'; - document.body.appendChild(injectCSS); + if (options.font === 'bootstrap-icons') { + this.$el.addClass('bt-checkbox-bootstrap-icons'); } this.on('getRuleInput.filter', function(h, rule, name) { @@ -35,22 +24,18 @@ QueryBuilder.define('bt-checkbox', function(options) { filter.colors._def_ = filter.color; } - var style = filter.vertical ? ' style="display:block"' : '', - i = 0, color, id; + var style = filter.vertical ? ' style="display:block"' : ''; + var i = 0; - iterateOptions(filter.values, function(key, val) { - color = filter.colors[key] || filter.colors._def_ || options.color; - id = name +'_'+ (i++); + Utils.iterateOptions(filter.values, function(key, val) { + var color = filter.colors[key] || filter.colors._def_ || options.color; + var id = name + '_' + (i++); - h.value+= '\ - \ - \ - '+ val +' \ -