gridx-rails 1.1.0

data/app/assets/javascripts/gridx/modules/filter/FilterDialog.js

@@ -0,0 +1,179 @@
+define([
+	"dojo/_base/declare",
+	"dojo/_base/lang",
+	"dojo/_base/array",
+	"dojo/dom-class",
+	"dojo/string",
+	"dojo/query",
+	"dojo/keys",
+	"dijit/registry",
+	"dijit/Dialog",
+	"dojox/html/metrics",
+	"./FilterPane",
+	"dojo/text!../../templates/FilterDialog.html",
+	"dijit/form/Select",
+	"dijit/form/Button",
+	"dijit/layout/AccordionContainer"
+], function(declare, lang, array, css, string, query, keys, registry, Dialog, metrics, FilterPane, template){
+
+/*=====
+	return declare([], {
+	});
+=====*/
+
+	return declare(Dialog, {
+		cssClass: 'gridxFilterDialog',
+		grid: null,
+		autofocus: false,
+		
+		postCreate: function(){
+			this.inherited(arguments);
+			this.i18n = this.grid.filterBar._nls;
+			this.set('content', string.substitute(template, this));
+			this._initWidgets();
+			css.add(this.domNode, 'gridxFilterDialog');
+		},
+		
+		done: function(){
+			// summary:
+			//	Apply the filter.
+			this.hide();
+			this.grid.filterBar.applyFilter(this.getData());
+		},
+		
+		getData: function(){
+			// summary:
+			//	Get filter data.
+			return {
+				type: this._sltMatch.get('value'),
+				conditions: array.map(this._accordionContainer.getChildren(), function(p){
+					return p.getData();
+				})
+			};
+		},
+		
+		setData: function(data){
+			// summary:
+			//	Set filter data.
+			this.removeChildren();
+			if(!data || !data.conditions.length){
+				return;
+			}
+			this._sltMatch.set('value', 'all' && data && data.type);
+			array.forEach(data.conditions, function(d){
+				this.addRule().setData(d);
+			}, this);
+		},
+		
+		removeChildren: function(){
+			// summary:
+			//	Remove all child of the accodion container.
+			array.forEach(this._accordionContainer.getChildren(), function(child){
+				this._accordionContainer.removeChild(child);
+				child.destroy();
+			}, this);
+		
+		},
+		
+		clear: function(){
+			this.grid.filterBar.confirmToExecute(function(){
+				this.grid.filterBar.clearFilter(true);
+				this.hide();
+			}, this);
+		},
+		
+		cancel: function(){
+			this.hide();
+		},
+		
+		show: function(){
+			this.inherited(arguments);
+			if(!this._accordionContainer.hasChildren()){
+				this.addRule();
+			}
+		},
+		
+		addRule: function(){
+			var ac = this._accordionContainer;
+			if(ac.getChildren().length === 3){
+				ac._contentBox.w -= metrics.getScrollbar().w;
+			}
+			var nextRuleNumber = ac.getChildren().length + 1;
+			var ruleTitle = string.substitute(this.i18n.ruleTitleTemplate, {ruleNumber: nextRuleNumber});
+			var fp = new FilterPane({grid: this.grid, title: ruleTitle});
+			ac.addChild(fp);
+			ac.selectChild(fp);
+			
+			if(!this._titlePaneHeight){
+				this._titlePaneHeight = fp._buttonWidget.domNode.offsetHeight + 3;
+			}
+			fp._initCloseButton();
+			fp._onColumnChange();
+			try{
+				fp.tbSingle.focus();//TODO: this doesn't work now.
+			}catch(e){}
+			css.toggle(ac.domNode, 'gridxFilterSingleRule', ac.getChildren().length === 1);
+			
+			fp.connect(fp, 'onChange', lang.hitch(this, '_updateButtons'));
+			this._updateButtons();
+			this._updateAccordionContainerHeight();
+			//scroll to bottom when add a rule
+			ac.domNode.parentNode.scrollTop = 100000;
+			return fp;
+		},
+		
+		_initWidgets: function(){
+			var form = dojo.query('form', this.domNode)[0], _this = this;
+			form.onsubmit = function(){
+				_this.done();
+				return false;
+			}
+			this._accordionContainer = registry.byNode(query('.dijitAccordionContainer', this.domNode)[0]);
+			this._sltMatch = registry.byNode(query('.dijitSelect', this.domNode)[0]);
+			var btns = query('.dijitButton', this.domNode);
+			this._btnAdd = registry.byNode(btns[0]);
+			this._btnFilter = registry.byNode(btns[1]);
+			this._btnClear = registry.byNode(btns[2]);
+			this._btnCancel = registry.byNode(btns[3]);
+			this.connect(this._btnAdd, 'onClick', 'addRule');
+			this.connect(this._btnClear, 'onClick', 'clear');
+			this.connect(this._btnCancel, 'onClick', 'cancel');
+			this.connect(this._accordionContainer, 'removeChild', '_updateButtons');
+			this.connect(this._accordionContainer, 'removeChild', '_updatePaneTitle');
+		},
+		
+		_updatePaneTitle: function(){
+			// summary:
+			//		Update each pane title. Only called after remove a RULE pane.
+			array.forEach(this._accordionContainer.getChildren(), function(pane){
+				pane._updateTitle();
+			});
+		},
+		
+		_updateButtons: function(){
+			var children = this._accordionContainer.getChildren();
+			//toggle filter button disable
+			if(array.some(children, function(c){return c.getData() === null;})){
+				this._btnFilter.set('disabled', true);
+			}else{
+				this._btnFilter.set('disabled', false);
+			}
+			//toggle add rule button disable
+			var c = this.grid.filterBar.arg('maxRuleCount');
+			this._btnAdd.set('disabled', children.length >= c && c > 0);
+			this._btnClear.set('disabled', !this.grid.filterBar.filterData);
+		},
+		
+		_updateAccordionContainerHeight: function(){
+			// summary:
+			//	Update the height of the accordion container to ensure consistent height of each accordion pane.
+			var ac = this._accordionContainer, len = ac.getChildren().length;
+			ac.domNode.style.height = 145 + len * this._titlePaneHeight + 'px';
+			ac.resize();
+		},
+		uninitialize: function(){
+			this.inherited(arguments);
+		}
+		
+	});
+});

data/app/assets/javascripts/gridx/modules/filter/FilterPane.js

@@ -0,0 +1,340 @@
+define([
+	"dojo/_base/declare",
+	"dojo/_base/lang",
+	"dojo/_base/array",
+	"dojo/dom-construct",
+	"dojo/dom-class",
+	"dojo/string",
+	"dojo/query",
+	"dijit/registry",
+	"dojox/html/ellipsis",
+	"dojox/html/metrics",
+	"./DistinctComboBoxMenu",
+	"../Filter",
+	"dojo/text!../../templates/FilterPane.html",
+	"dojo/i18n!../../nls/FilterBar",
+	"dijit/layout/ContentPane",
+	"dijit/_BidiSupport",
+	"dijit/form/Select",
+	"dijit/form/TextBox",
+	"dijit/form/DateTextBox",
+	"dijit/form/TimeTextBox",
+	"dijit/form/RadioButton",
+	"dijit/form/NumberTextBox",
+	"dijit/form/ComboBox"
+], function(declare, lang, array, dom, css, string, query, registry, ellipsis, metrics, DistinctComboBoxMenu, Filter, template, i18n, ContentPane, _BidiSupport){
+
+/*=====
+	return declare([], {
+	});
+=====*/
+
+	var ANY_COLUMN_VALUE = '_gridx_any_column_value_';
+	
+	function isAnyColumn(colid){
+		return colid == ANY_COLUMN_VALUE;
+	}
+	return declare([ContentPane], {
+		//content: template,
+		sltColumn: null,
+		sltCondition: null,
+		grid: null,
+		postCreate: function(){
+			this.inherited(arguments);
+			this.i18n = this.grid.filterBar._nls;
+			this.set('title', this.i18n.defaultRuleTitle);
+			this.set('content', string.substitute(template, this));
+			this._initFields();
+			this._initSltCol();
+			this.connect(this.sltColumn, 'onChange', '_onColumnChange');
+			this.connect(this.sltCondition, 'onChange', '_onConditionChange');
+			this.comboText.dropDownClass = DistinctComboBoxMenu;
+			this._onConditionChange();//In the latest dijit, onChange event is no longer fired after creation
+		},
+	
+		getData: function(){
+			// summary:
+			//		Get the filter defined by this filter pane.
+			var value = this._getValue(), 
+				colId = this.sltColumn.get('value'),
+				condition = this.sltCondition.get('value');
+			
+			if(condition === 'isEmpty' || (value !== null && (condition !== 'range' || (value.start && value.end)))){
+				return {
+					colId: isAnyColumn(colId) ? '' : colId,
+					condition: condition,
+					//fix defect #10741
+					//set('value', '') on DateTimeBox will set date to 1/1/1970
+					//so, set('value', null) when condition is empty on a DateTimeBoxs
+					value: condition === 'isEmpty'? ( this._getType() === 'Date'? null : '') : value,
+					type: this._getType()
+				};
+			}else{
+				return null;
+			}
+		},
+		setData: function(data){
+			// summary:
+			//		Set the data of the pane to restore UI.
+			if(data === null){return;}
+			this.sltColumn.set('value', data.colId, null);
+			this._onColumnChange();
+			var _this = this;
+			
+			window.setTimeout(function(){
+				_this.sltCondition.set('value', data.condition, null);
+				_this._onConditionChange();
+				_this._setValue(data.value);
+			}, 10);
+		},
+		close: function(){
+			var ac = this._getContainer();
+			if(ac.getChildren().length === 4){
+				//while there's less than 4 rules, no scroll bar
+				ac._contentBox.w += metrics.getScrollbar().w;
+			}
+			
+			if(this === ac.selectedChildWidget){
+				//select previous pane if this is current, consistent with EDG filter.
+				var i = array.indexOf(ac.getChildren(), this);
+				if(i > 0){ac.selectChild(ac.getChildren()[i-1]);}
+			}
+			
+			ac.removeChild(this);
+			css.toggle(ac.domNode, 'gridxFilterSingleRule', ac.getChildren().length === 1);
+			this.grid.filterBar._filterDialog._updateAccordionContainerHeight();
+		},
+		onChange: function(){
+			// summary:
+			//		event: fired when column, condition or value is changed
+		},
+		_getContainer: function(){
+			return registry.byNode(this.domNode.parentNode.parentNode.parentNode);
+		},
+		_initFields: function(){
+			this.sltColumn = registry.byNode(query('li>table', this.domNode)[0]);
+			this.sltCondition = registry.byNode(query('li>table', this.domNode)[1]);
+			var fields = this._fields = [
+				this.tbSingle = registry.byNode(query('.gridxFilterPaneTextWrapper > .dijitTextBox', this.domNode)[0]),
+				this.tbNumber = registry.byNode(query('.gridxFilterPaneNumberWrapper > .dijitTextBox', this.domNode)[0]),
+				this.comboText = registry.byNode(query('.gridxFilterPaneComboWrapper > .dijitComboBox', this.domNode)[0]),
+				this.sltSingle = registry.byNode(query('.gridxFilterPaneSelectWrapper > .dijitSelect', this.domNode)[0]),
+				this.dtbSingle = registry.byNode(query('.gridxFilterPaneDateWrapper > .dijitDateTextBox', this.domNode)[0]),
+				this.dtbStart = registry.byNode(query('.gridxFilterPaneDateRangeWrapper > .dijitDateTextBox', this.domNode)[0]),
+				this.dtbEnd = registry.byNode(query('.gridxFilterPaneDateRangeWrapper > .dijitDateTextBox', this.domNode)[1]),
+				this.ttbSingle = registry.byNode(query('.gridxFilterPaneTimeWrapper > .dijitTimeTextBox', this.domNode)[0]),
+				this.ttbStart = registry.byNode(query('.gridxFilterPaneTimeRangeWrapper > .dijitTimeTextBox', this.domNode)[0]),
+				this.ttbEnd = registry.byNode(query('.gridxFilterPaneTimeRangeWrapper > .dijitTimeTextBox', this.domNode)[1]),
+				this.rbTrue = registry.byNode(query('.gridxFilterPaneRadioWrapper .dijitRadio', this.domNode)[0]),
+				this.rbFalse = registry.byNode(query('.gridxFilterPaneRadioWrapper .dijitRadio', this.domNode)[1])
+			];
+			
+			this.rbTrue.domNode.nextSibling.htmlFor = this.rbTrue.id;
+			this.rbFalse.domNode.nextSibling.htmlFor = this.rbFalse.id;
+			var name = 'rb_name_' + Math.random();
+			this.rbTrue.set('name', name);
+			this.rbFalse.set('name', name);
+			
+			array.forEach(fields, function(field){
+				this.connect(field, 'onChange', '_onValueChange');
+			}, this);
+		},
+		_initSltCol: function(){
+			var colOpts = [{label: this.i18n.anyColumnOption, value: ANY_COLUMN_VALUE}],
+				fb = this.grid.filterBar, 
+				sltCol = this.sltColumn;
+			array.forEach(this.grid.columns(), function(col){
+				if(!col.isFilterable())return;
+				var colName = col.name();
+				colName = this.grid.enforceTextDirWithUcc(col.id, colName);
+				colOpts.push({value: col.id, label: colName});
+			}, this);
+			sltCol.addOption(colOpts);
+		},
+		_initCloseButton: function(){
+			// summary:
+			//		Add a close button to the accordion pane.
+			//		Must be called after adding to an accordion container.
+			var btnWidget = this._buttonWidget;
+			var closeButton = dom.create('span', {
+				className: 'gridxFilterPaneCloseButton',
+				innerHTML: '<img src="' + this._blankGif + '"/>',
+				tabIndex: 0,
+				title: this.i18n.removeRuleButton || ''
+			}, btnWidget.domNode, 'last');
+			this.connect(closeButton, 'onclick', 'close');
+			css.add(btnWidget.titleTextNode, 'dojoxEllipsis');
+		},
+		
+		_onColumnChange: function(){
+			var colId = this.sltColumn.get('value');
+			var opt = this.grid.filterBar._getConditionOptions(isAnyColumn(colId) ? '' : colId);
+			var slt = this.sltCondition;
+			//if(slt.options && slt.options.length){slt.removeOption(slt.options);}
+			slt.set('options', []);
+			slt.addOption(lang.clone(opt));
+			this._updateTitle();
+			this._updateValueField();
+			this.onChange();
+		},
+		_onConditionChange: function(){
+			this._updateValueField();
+			this._updateTitle();
+			this.onChange();
+		},
+		_onValueChange: function(){
+			if(this.grid.textDir && this.grid.textDir == 'auto'){
+				this.tbSingle.focusNode.dir = _BidiSupport.prototype._checkContextual(this._getValue());
+			}
+			this._updateTitle();
+			this.onChange();
+		},
+		_getDataType: function(){
+			// summary:
+			//		Get current column data type
+			var colid = this.sltColumn.get('value');
+			var dataType = 'string';
+			if(!isAnyColumn(colid)){
+				dataType = this.grid.column(colid).dataType();
+			}
+			return dataType;
+		},
+		_getType: function(){
+			// summary:
+			//		Get current filter type, determined by data type and condition.
+			var mapping = {'string': 'Text', number: 'Number', date: 'Date', time: 'Time', 'enum': 'Select', 'boolean': 'Radio'};
+			var type = mapping[this._getDataType()];
+			if('range' === this.sltCondition.get('value')){type += 'Range';} ;
+			return type;
+		},
+		_updateTitle: function(){
+			if(!this._buttonWidget){return;}
+			var title, value = this._getValue(), 
+				type = this._getType(), condition = this.sltCondition.get('value'),
+				txtNode = this._buttonWidget.titleTextNode;
+			
+			if(this._isValidValue(value) && (condition !== 'range' || (value.start && value.end))){
+				title = this.sltColumn.get('displayedValue') + ' ' + this.grid.filterBar._getRuleString(condition, value, type);
+			}else{
+				var ruleNumber = array.indexOf(this._getContainer().getChildren(), this) + 1;
+				title = string.substitute(this.i18n.ruleTitleTemplate, {ruleNumber: ruleNumber});
+			}
+			txtNode.innerHTML = title;
+			txtNode.title = title.replace(/<\/?span[^>]*>/g, '').replace('&nbsp;', ' ');
+		},
+		_needComboBox: function(){
+			// summary:
+			//		Whether current state needs a combo box for string input, may rewrite to support virtual column
+			var colId = this.sltColumn.get('value');
+			return this._getType() === 'Text' && !isAnyColumn(colId) && this.grid._columnsById[colId].field;
+		},
+		_updateValueField: function(){
+			// summary:
+			//		Update the UI for field to show/hide fields.
+			var type = this._getType(), colId = this.sltColumn.get('value');
+			var combo = this._needComboBox();
+			
+			array.forEach(['Text','Combo', 'Date', 'Number', 'DateRange', 'Time', 'TimeRange', 'Select', 'Radio'], function(k){
+				css.remove(this.domNode, 'gridxFilterPane' + k);
+			}, this);
+			
+			css.add(this.domNode, 'gridxFilterPane' + (combo ? 'Combo' : type));
+			var disabled = this.sltCondition.get('value') === 'isEmpty';
+			array.forEach(this._fields, function(f){f.set('disabled', disabled)});
+			
+			var col = this.grid._columnsById[colId];
+			if(combo){
+				if(!this._dummyCombo){
+					//HACK: mixin query, get, etc methods to store, remove from 2.0.
+					this._dummyCombo = new dijit.form.ComboBox({store: this.grid.store});
+				}
+				//init combobox
+				if(col.autoComplete !== false){
+					lang.mixin(this.comboText, {
+						store: this.grid.store,
+						searchAttr: col.field,
+						fetchProperties: {sort:[{attribute: col.field, descending: false}]}
+					});
+				}
+			}
+			if(type == 'Select'){
+				var sltSingle = this.sltSingle;
+				sltSingle.removeOption(sltSingle.getOptions());
+				sltSingle.addOption(array.map(col.enumOptions || [], function(option){
+					return lang.isObject(option) ? option : {
+						label: option,
+						value: option
+					};
+				}));
+				this._updateTitle();
+			}
+		},
+		_getValue: function(){
+			// summary:
+			//		Get current filter value
+			var type = this._getType(), combo = this._needComboBox();
+			switch(type){
+				case 'Text':
+					return (combo ? this.comboText : this.tbSingle).get('value') || null;
+				case 'Number':
+					return isNaN(this.tbNumber.get('value')) ? null : this.tbNumber.get('value');
+				case 'Select':
+					return this.sltSingle.get('value') || null;
+				case 'Date':
+					return this.dtbSingle.get('value') || null;
+				case 'DateRange':
+					return {start: this.dtbStart.get('value'), end: this.dtbEnd.get('value')};
+				case 'Time':
+					return this.ttbSingle.get('value') || null;
+				case 'TimeRange':
+					return {start: this.ttbStart.get('value'), end: this.ttbEnd.get('value')};
+				case 'Radio':
+					return !!this.rbTrue.get('checked');
+				default:
+					return null;
+			}
+		},
+		_setValue: function(value){
+			if(!this._isValidValue(value)){return;}
+			var type = this._getType(), combo = this._needComboBox();
+			switch(type){
+				case 'Text':
+					(combo ? this.comboText : this.tbSingle).set('value', value);
+					break;
+				case 'Number':
+					this.tbNumber.set('value', value);
+					break;
+				case 'Select':
+					this.sltSingle.set('value', value);
+					break;
+				case 'Date':
+					this.dtbSingle.set('value', value);
+					break;
+				case 'DateRange':
+					this.dtbStart.set('value', value.start);
+					this.dtbEnd.set('value', value.end);
+					break;
+				case 'Time':
+					this.ttbSingle.set('value', value);
+					break;
+				case 'TimeRange':
+					this.ttbStart.set('value', value.start);
+					this.ttbEnd.set('value', value.end);
+					break;
+				case 'Radio':
+					if(value){this.rbTrue.set('checked', true);}
+					else{this.rbFalse.set('checked', true);}
+					break;
+			}
+		},
+		
+		_isValidValue: function(value){
+			return value !== null && value != undefined;
+		},
+		
+		uninitialize: function(){
+			this.inherited(arguments);
+			if(this._dummyCombo){this._dummyCombo.destroyRecursive();}
+		}
+	});
+});

data/app/assets/javascripts/gridx/modules/filter/FilterTooltip.js

@@ -0,0 +1,103 @@
+define([
+	"dojo/_base/array",
+	"dojo/_base/event",
+	"dojo/dom-class",
+	"dijit/popup",
+	"dojo/_base/declare",
+	"dojo/string",
+	"dijit/TooltipDialog"
+], function(array, event, domClass, popup, declare, string, TooltipDialog){
+
+/*=====
+	return declare([], {
+		// summary:
+		//		Show status dialog of filter.
+	});
+=====*/
+
+	return declare(TooltipDialog, {
+		grid: null,
+		filterBar: null,
+		postCreate: function(){
+			this.inherited(arguments);
+			this.filterBar = this.grid.filterBar;
+			this.connect(this, 'onClick', '_onClick');
+			this.connect(this, 'onMouseEnter', '_onMouseEnter');
+			this.connect(this, 'onMouseLeave', '_onMouseLeave');
+			domClass.add(this.domNode, 'gridxFilterTooltip');
+			domClass.add(this.domNode, 'dijitTooltipBelow');
+		},
+		show: function(evt){
+			this.inherited(arguments);
+			popup.open({
+				popup: this,
+				x: evt.pageX,
+				y: evt.pageY,
+				padding: {x: -6, y: -3}
+			});
+		},
+		hide: function(){
+			this.inherited(arguments);
+			popup.close(this);
+		},
+
+		buildContent: function(){
+			// summary:
+			//		Build the status of current filter.
+			
+			var fb = this.filterBar, nls = fb._nls, data = fb.filterData;
+			if(!data || !data.conditions.length){return;}
+			
+			var typeString = data.type === 'all' ? nls.statusTipHeaderAll : nls.statusTipHeaderAny;
+			var arr = ['<div class="gridxFilterTooltipTitle"><b>${i18n.statusTipTitleHasFilter}</b> ', 
+				typeString, '</div><table><tr><th>${i18n.statusTipHeaderColumn}</th><th>${i18n.statusTipHeaderCondition}</th></tr>'
+			];
+			array.forEach(data.conditions, function(d, idx){
+				var odd = idx%2 ? ' class="gridxFilterTooltipOddRow"' : '';
+				if(d.colId){
+					var colName = this.grid.column(d.colId).name();
+					colName = this.grid.enforceTextDirWithUcc(d.colId, colName);
+				}
+				arr.push('<tr', odd, '><td>', (d.colId ? colName : '${i18n.anyColumnOption}'), 
+					'</td><td class="gridxFilterTooltipValueCell">', 
+					'<div>',
+					fb._getRuleString(d.condition, d.value, d.type),
+					'<span action="remove-rule" title="${i18n.removeRuleButton}"',
+					' class="gridxFilterTooltipRemoveBtn"><span class="gridxFilterTooltipRemoveBtnText">x</span></span></div></td></tr>');
+			}, this);
+			arr.push('</table>');
+			this.i18n = this.grid.filterBar._nls;
+			this.set('content', string.substitute(arr.join(''), this));
+			domClass.toggle(this.domNode, 'gridxFilterTooltipSingleRule', data.conditions.length === 1);
+		},
+		_onMouseEnter: function(e){
+			this.isMouseOn = true;
+		},
+		_onMouseLeave: function(e){
+			this.isMouseOn = false;
+			this.hide();
+		},
+		_onClick: function(e){
+			var tr = this._getTr(e), fb = this.filterBar;
+			if(tr && /^span$/i.test(e.target.tagName)){
+				//remove the rule
+				fb.filterData.conditions.splice(tr.rowIndex - 1, 1);
+				tr.parentNode.removeChild(tr);
+				fb.applyFilter(fb.filterData);
+				event.stop(e);
+			}else{
+				this.filterBar.showFilterDialog();
+				this.hide();
+			}
+		},
+		_getTr: function(e){
+			// summary:
+			//		Get table row of status
+			var tr = e.target;
+			while(tr && !/^tr$/i.test(tr.tagName) && tr !== this.domNode){
+				tr = tr.parentNode;
+			}
+			return (tr && /^tr$/i.test(tr.tagName)) ? tr : null;
+		}
+	});
+});

data/app/assets/javascripts/gridx/modules/filter/QuickFilter.js

@@ -0,0 +1,33 @@
+define([
+	'dojo/_base/declare',
+	'../../core/_Module',
+	'../../support/QuickFilter',
+	'../Bar'
+], function(declare, _Module, QuickFilter){
+
+/*=====
+	return declare(_Module, {
+		// summary:
+		//		Directly show gridx/support/QuickFilter in gridx/modules/Bar at the top/right position.
+		// description:
+		//		This module is only for convenience. For other positions or more configurations, please use gridx/modules/Bar directly.
+		//		This module depends on "bar" and "filter" modules.
+	});
+=====*/
+
+	return declare(_Module, {
+		name: 'quickFilter',
+
+		required: ['bar', 'filter'],
+
+		preload: function(){
+			this.grid.bar.defs.push({
+				bar: 'top',
+				row: 0,
+				col: 3,
+				pluginClass: QuickFilter,
+				className: 'gridxBarQuickFilter'
+			});
+		}
+	});
+});