Filter2.html 7.91 KB
<!DOCTYPE html>
<html>
<head>
  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
  <title>The source code</title>
  <link href="../resources/prettify/prettify.css" type="text/css" rel="stylesheet" />
  <script type="text/javascript" src="../resources/prettify/prettify.js"></script>
  <style type="text/css">
    .highlight { display: block; background-color: #ddd; }
  </style>
  <script type="text/javascript">
    function highlight() {
      document.getElementById(location.hash.replace(/#/, "")).className = "highlight";
    }
  </script>
</head>
<body onload="prettyPrint(); highlight();">
  <pre class="prettyprint lang-js"><span id='Ext-ux-grid-filter-Filter'>/**
</span> * @class Ext.ux.grid.filter.Filter
 * @extends Ext.util.Observable
 * Abstract base class for filter implementations.
 */
Ext.define('Ext.ux.grid.filter.Filter', {
    extend: 'Ext.util.Observable',

<span id='Ext-ux-grid-filter-Filter-cfg-active'>    /**
</span>     * @cfg {Boolean} active
     * Indicates the initial status of the filter (defaults to false).
     */
    active : false,
<span id='Ext-ux-grid-filter-Filter-property-active'>    /**
</span>     * True if this filter is active.  Use setActive() to alter after configuration.
     * @type Boolean
     * @property active
     */
<span id='Ext-ux-grid-filter-Filter-cfg-dataIndex'>    /**
</span>     * @cfg {String} dataIndex
     * The {@link Ext.data.Store} dataIndex of the field this filter represents.
     * The dataIndex does not actually have to exist in the store.
     */
    dataIndex : null,
<span id='Ext-ux-grid-filter-Filter-property-menu'>    /**
</span>     * The filter configuration menu that will be installed into the filter submenu of a column menu.
     * @type Ext.menu.Menu
     * @property
     */
    menu : null,
<span id='Ext-ux-grid-filter-Filter-cfg-updateBuffer'>    /**
</span>     * @cfg {Number} updateBuffer
     * Number of milliseconds to wait after user interaction to fire an update. Only supported
     * by filters: 'list', 'numeric', and 'string'. Defaults to 500.
     */
    updateBuffer : 500,

    constructor : function (config) {
        Ext.apply(this, config);

        this.addEvents(
<span id='Ext-ux-grid-filter-Filter-event-activate'>            /**
</span>             * @event activate
             * Fires when an inactive filter becomes active
             * @param {Ext.ux.grid.filter.Filter} this
             */
            'activate',
<span id='Ext-ux-grid-filter-Filter-event-deactivate'>            /**
</span>             * @event deactivate
             * Fires when an active filter becomes inactive
             * @param {Ext.ux.grid.filter.Filter} this
             */
            'deactivate',
<span id='Ext-ux-grid-filter-Filter-event-serialize'>            /**
</span>             * @event serialize
             * Fires after the serialization process. Use this to attach additional parameters to serialization
             * data before it is encoded and sent to the server.
             * @param {Array/Object} data A map or collection of maps representing the current filter configuration.
             * @param {Ext.ux.grid.filter.Filter} filter The filter being serialized.
             */
            'serialize',
<span id='Ext-ux-grid-filter-Filter-event-update'>            /**
</span>             * @event update
             * Fires when a filter configuration has changed
             * @param {Ext.ux.grid.filter.Filter} this The filter object.
             */
            'update'
        );
        Ext.ux.grid.filter.Filter.superclass.constructor.call(this);

        this.menu = this.createMenu(config);
        this.init(config);
        if(config &amp;&amp; config.value){
            this.setValue(config.value);
            this.setActive(config.active !== false, true);
            delete config.value;
        }
    },

<span id='Ext-ux-grid-filter-Filter-method-destroy'>    /**
</span>     * Destroys this filter by purging any event listeners, and removing any menus.
     */
    destroy : function(){
        if (this.menu){
            this.menu.destroy();
        }
        this.clearListeners();
    },

<span id='Ext-ux-grid-filter-Filter-method-init'>    /**
</span>     * Template method to be implemented by all subclasses that is to
     * initialize the filter and install required menu items.
     * Defaults to Ext.emptyFn.
     */
    init : Ext.emptyFn,

<span id='Ext-ux-grid-filter-Filter-method-createMenu'>    /**
</span>     * @private @override
     * Creates the Menu for this filter.
     * @param {Object} config Filter configuration
     * @return {Ext.menu.Menu}
     */
    createMenu: function(config) {
        return Ext.create('Ext.menu.Menu', config);
    },

<span id='Ext-ux-grid-filter-Filter-method-getValue'>    /**
</span>     * Template method to be implemented by all subclasses that is to
     * get and return the value of the filter.
     * Defaults to Ext.emptyFn.
     * @return {Object} The 'serialized' form of this filter
     * @methodOf Ext.ux.grid.filter.Filter
     */
    getValue : Ext.emptyFn,

<span id='Ext-ux-grid-filter-Filter-method-setValue'>    /**
</span>     * Template method to be implemented by all subclasses that is to
     * set the value of the filter and fire the 'update' event.
     * Defaults to Ext.emptyFn.
     * @param {Object} data The value to set the filter
     * @methodOf Ext.ux.grid.filter.Filter
     */
    setValue : Ext.emptyFn,

<span id='Ext-ux-grid-filter-Filter-method-isActivatable'>    /**
</span>     * Template method to be implemented by all subclasses that is to
     * return &lt;tt&gt;true&lt;/tt&gt; if the filter has enough configuration information to be activated.
     * Defaults to &lt;tt&gt;return true&lt;/tt&gt;.
     * @return {Boolean}
     */
    isActivatable : function(){
        return true;
    },

<span id='Ext-ux-grid-filter-Filter-method-getSerialArgs'>    /**
</span>     * Template method to be implemented by all subclasses that is to
     * get and return serialized filter data for transmission to the server.
     * Defaults to Ext.emptyFn.
     */
    getSerialArgs : Ext.emptyFn,

<span id='Ext-ux-grid-filter-Filter-method-validateRecord'>    /**
</span>     * Template method to be implemented by all subclasses that is to
     * validates the provided Ext.data.Record against the filters configuration.
     * Defaults to &lt;tt&gt;return true&lt;/tt&gt;.
     * @param {Ext.data.Record} record The record to validate
     * @return {Boolean} true if the record is valid within the bounds
     * of the filter, false otherwise.
     */
    validateRecord : function(){
        return true;
    },

<span id='Ext-ux-grid-filter-Filter-method-serialize'>    /**
</span>     * Returns the serialized filter data for transmission to the server
     * and fires the 'serialize' event.
     * @return {Object/Array} An object or collection of objects containing
     * key value pairs representing the current configuration of the filter.
     * @methodOf Ext.ux.grid.filter.Filter
     */
    serialize : function(){
        var args = this.getSerialArgs();
        this.fireEvent('serialize', args, this);
        return args;
    },

<span id='Ext-ux-grid-filter-Filter-method-fireUpdate'>    /** @private */
</span>    fireUpdate : function(){
        if (this.active) {
            this.fireEvent('update', this);
        }
        this.setActive(this.isActivatable());
    },

<span id='Ext-ux-grid-filter-Filter-method-setActive'>    /**
</span>     * Sets the status of the filter and fires the appropriate events.
     * @param {Boolean} active        The new filter state.
     * @param {Boolean} suppressEvent True to prevent events from being fired.
     * @methodOf Ext.ux.grid.filter.Filter
     */
    setActive : function(active, suppressEvent){
        if(this.active != active){
            this.active = active;
            if (suppressEvent !== true) {
                this.fireEvent(active ? 'activate' : 'deactivate', this);
            }
        }
    }
});
</pre>
</body>
</html>