# Class Ext.LoadMask

Package: | Ext
Defined In: | LoadMask.js
Class: | LoadMask
Extends: | Object

A simple utility class for generically masking elements while loading data. If the store config option is specified, the masking will be automatically synchronized with the store's loading process and the mask element will be cached for reuse. For all other elements, this mask will replace the element's Updater load indicator and will be destroyed after the initial load.

Example usage:

    // Basic mask:
    var myMask = new Ext.LoadMask(Ext.getBody(), {msg:"Please wait..."});
    myMask.show();

## Config Options

Config Options | Defined By
--- | ---
| msg : String The text to display in a centered loading message box (defaults to 'Loading...') | LoadMask
| msgCls : String The CSS class to apply to the loading message element (defaults to "x-mask-loading") | LoadMask
| removeMask : Boolean True to create a single-use mask that is automatically destroyed after loading (useful for page loads), False to pers... True to create a single-use mask that is automatically destroyed after loading (useful for page loads), False to persist the mask element reference for multiple uses (e.g., for paged data widgets). Defaults to false. | LoadMask
| store : Ext.data.Store Optional Store to which the mask is bound. The mask is displayed when a load request is issued, and hidden on either ... Optional Store to which the mask is bound. The mask is displayed when a load request is issued, and hidden on either load sucess, or load fail. | LoadMask

## Public Properties

Property | Defined By
--- | ---
| disabled : Boolean Read-only. True if the mask is currently disabled so that it will not be displayed (defaults to false) | LoadMask

## Public Methods

Method | Defined By
--- | ---
| LoadMask( `Mixed el`, `Object config` ) Create a new LoadMask Create a new LoadMask Parameters: `el` : Mixed The element or DOM node, or its id `config` : Object The config object Returns: void | LoadMask
| disable() : void Disables the mask to prevent it from being displayed Disables the mask to prevent it from being displayed Parameters: None. Returns: void | LoadMask
| enable() : void Enables the mask so that it can be displayed Enables the mask so that it can be displayed Parameters: None. Returns: void | LoadMask
| hide() : void Hide this LoadMask. Hide this LoadMask. Parameters: None. Returns: void | LoadMask
| show() : void Show this LoadMask over the configured Element. Show this LoadMask over the configured Element. Parameters: None. Returns: void | LoadMask

## Public Events

This class has no public events.