Results:
Loading...
Javascript Data GridJavascriptReact Data GridReactAngular Data GridAngularVue Data GridVue

Vue Data GridOverlays

At present, there are two overlays for the grid when using the Client-Side Row Model:

  • Loading: Gets displayed when the grid is loading data.
  • No Rows: Gets displayed when loading has completed but there are no rows to show.

The grid manages showing and hiding of the overlays for you. When the table is first initialised, the loading panel is displayed if rowData is set to null or undefined. When the API function setRowData is called, the loading panel is hidden.

Overlays are not used when using Row Models other than the Client-Side Row Model. This is because data is loaded differently.

The Loading overlay doesn't make sense as rows are loaded in sections. Access to the entire grid shouldn't be blocked as some rows will be loaded while others are loading.

The No Rows overlay doesn't make sense as there could be rows on the server, but a filter could be applied that filters out all rows. This would be equivalent to the Client-Side Row Model and applying a filter to some data (no overlay would be shown, and a grid with a filter and no rows would be shown).

Overlay API

At any point, you can show or hide any of the overlays using the methods below. You may never need to use these methods, as the grid manages the overlays for you. However you may find some edge cases where you need complete control (such as showing 'loading' if an option outside the grid is changed).

showLoadingOverlay
Function
Show the 'loading' overlay. 
showLoadingOverlay = () => void;
showNoRowsOverlay
Function
Show the 'no rows' overlay. 
showNoRowsOverlay = () => void;
hideOverlay
Function
Hides the overlay if showing. 
hideOverlay = () => void;

The overlays are mutually exclusive, you cannot show more than one overlay at any given time.

Custom Overlays

If you're not happy with the provided overlay templates, you can provide your own in the following two ways.

  1. Provide a plain HTML string to the grid properties overlayLoadingTemplate and overlayNoRowsTemplate.
  2. Provide a custom component for the overlay - see Overlay Component for details.

Example

The example below demonstrates how the loading overlay is shown automatically while the data is loading. You can also use the buttons to show / hide the different overlays at your will.

The overlays are customised by providing custom HTML templates to overlayLoadingTemplate and overlayNoRowsTemplate.

Example: Overlays
// Loading...