loadPanel

Specifies options configuring the load panel.

Type:

Object

When DataGrid operates with a large number of records or uses a remote storage as a data source, loading data takes time. As data is being prepared, DataGrid displays a load panel.

The load panel consists of a pane, a loading indicator and a text. You can specify whether the pane or loading indicator must be displayed using the showPane or showIndicator options respectively. The text displayed by the load panel can be specified using the text option. Also, you can change the height or width of the load panel using the corresponding options of the loadPanel configuration object.

Additionally, you can show/hide the load panel from code when using the beginCustomLoading(messageText) and endCustomLoading() methods.

Since the grid load panel is practically the DevExtreme LoadPanel widget, you can specify any option belonging to this widget in the loadPanel object.

enabled

Specifies whether to show the load panel or not.

Type:

String

|

Boolean

Default Value: 'auto'
Accepted Values: 'auto' | true | false

The default setting of the loadPanel | enabled option is specified to show the load panel for a remote data source only. If you need to show the load panel regardless of the data source type, assign true to this option. To disable the load panel, set this option to false.

height

Specifies the height of the load panel in pixels.

Type:

Number

Default Value: 90

indicatorSrc

Specifies a URL pointing to an image to be used as a loading indicator.

Type:

String

Default Value: ''

showIndicator

Specifies whether or not a loading indicator must be displayed on the load panel.

Type:

Boolean

Default Value: true

showPane

Specifies whether or not the pane of the load panel must be displayed.

Type:

Boolean

Default Value: true

text

Specifies text displayed by the load panel.

Type:

String

Default Value: 'Loading...'

width

Specifies the width of the load panel in pixels.

Type:

Number

Default Value: 200