add extjs 6.0.1 sources

[extjs.git] / extjs / modern / modern / src / Mask.js

/**\r
 * A simple class used to mask any {@link Ext.Container}.\r
 *\r
 * This should rarely be used directly, instead look at the {@link Ext.Container#masked} configuration.\r
 *\r
 * ## Example\r
 *\r
 *     @example miniphone\r
 *     // Create our container\r
 *     var container = Ext.create('Ext.Container', {\r
 *         html: 'My container!'\r
 *     });\r
 *\r
 *     // Add the container to the Viewport\r
 *     Ext.Viewport.add(container);\r
 *\r
 *     // Mask the container\r
 *     container.setMasked(true);\r
 */\r
Ext.define('Ext.Mask', {\r
    extend: 'Ext.Component',\r
    xtype: 'mask',\r
    requires: ['Ext.util.InputBlocker'],\r
\r
    config: {\r
        /**\r
         * @cfg\r
         * @inheritdoc\r
         */\r
        baseCls: Ext.baseCSSPrefix + 'mask',\r
\r
        /**\r
         * @cfg {Boolean} transparent True to make this mask transparent.\r
         */\r
        transparent: false,\r
\r
        /**\r
         * @cfg\r
         * @hide\r
         */\r
        top: 0,\r
\r
        /**\r
         * @cfg\r
         * @hide\r
         */\r
        left: 0,\r
\r
        /**\r
         * @cfg\r
         * @hide\r
         */\r
        right: 0,\r
\r
        /**\r
         * @cfg\r
         * @hide\r
         */\r
        bottom: 0\r
    },\r
\r
    /**\r
     * @event tap\r
     * A tap event fired when a user taps on this mask\r
     * @param {Ext.Mask} this The mask instance\r
     * @param {Ext.EventObject} e The event object\r
     */\r
    initialize: function() {\r
        var me = this;\r
\r
        me.callParent();\r
        me.element.on('tap', 'onTap', me);\r
        me.on('hide', 'onHide', me);\r
    },\r
\r
    onHide: function(){\r
        Ext.util.InputBlocker.unblockInputs();\r
\r
        // Oh how I loves the Android\r
        if (Ext.browser.is.AndroidStock4 && Ext.os.version.getMinor() === 0) {\r
            var firstChild = this.element.getFirstChild();\r
            if (firstChild) {\r
                firstChild.redraw();\r
            }\r
        }\r
    },\r
\r
    onTap: function(e) {\r
        this.fireEvent('tap', this, e);\r
    },\r
\r
    updateTransparent: function(transparent) {\r
        this.toggleCls(this.getBaseCls() + '-transparent', transparent);\r
    }\r
});\r