Constructor
new module:caplin/grid/decorator/LoadingDataDecorator(mDecoratorConfig)
Constructs a
caplin.grid.decorator.LoadingDataDecorator
instance — end-users
will never need to do this themselves since grids are fully constructed based on their XML
definition files by the module:caplin/grid/GridComponentFactory
class.
The LoadingDataDecorator
renders a spinning wait icon whenever the grid is
waiting for data to arrive, so that users can see what is happening. The
showInitialLoad
attribute within the <loadingDataDecorator/>
tag, can be used to control whether a spinning icon will be displayed the first time the grid is
loaded — this will cause pages that contain grids to load more slowly than they otherwise
would.
This class displays the image source/images/grid/loadingIcon.gif
to show that
loading is in progress. It also uses the following CSS classes to position the image and provide
futher look and feel enhancements:
-
loadingIconContainer dataLoading
- CSS class assigned to the HTML element that contains the loading icon whilst the grid is awaiting the initial response to the request for row data. -
loadingIconContainer dataLoaded
- CSS class assigned to the HTML element that contains the loading icon after the initial response to the request for row data has been received. -
loadingIcon
- CSS class assigned to the loading icon's HTML image element.
Parameters:
Name | Type | Description |
---|---|---|
mDecoratorConfig |
Object | config object |