Loading and empty results
Distinguish loading, no data, and no search results.
Options
Changes below update the Grid and code immediately.
This example starts with a Loading orders message. It is not waiting for an actual network request.
View code
Sample data included in the code · 6 rows
Usage guide
#Display status guidance over the table to distinguish loading from empty search results.
Try it yourself
- Inspect loading
This example starts with a Loading orders message. It is not waiting for an actual network request.
- Show the order list
Disable Loading below the table to reveal the prepared sample orders.
- Create an empty search result
Enter a nonexistent term in Order search. Clear it and verify the data returns.
Compare loading, regular results, and no search results.
In an app, enable loading when a request starts and clear it on success or failure. Distinguish empty source data from rows hidden by search too.
Useful terms
- loading
- A setting indicating that data is being awaited.
- Overlay
- A status guidance area displayed over the table.
API reference
#Other properties8
| Attribute / Property | Type / Default | Description |
|---|---|---|
| showEmptyState | booleanDefault: true | Render the wrapper empty-state overlay. |
| emptyMessage | stringDefault: undefined | Message shown when source row data is empty. |
| noMatchesMessage | stringDefault: undefined | Message shown when filters hide every row. |
| clearFiltersLabel | stringDefault: undefined | Label for the no-matches clear-filters action. |
booleanDefault: false | External loading flag for spinner, debounce, and interaction lock. | |
| loadingMessage | stringDefault: undefined | Message rendered beside the loading spinner. |
| loadingMode | LoadingModeDefault: 'manual' | Loading-mode switch for manual, auto, or host-owned loading UI. |
| minLoadingDuration | numberDefault: DEFAULT_MIN_LOADING_DURATION_MS | Minimum visible duration for the loading spinner in ms. |
Events1
| Events | Detail type | Description |
|---|---|---|
GridEmptyStateActionDetail | Fires when an empty-state overlay action is clicked. |
Explore each feature
Learn when to use each feature and how to configure it. Each guide identifies live examples and features you connect in your app.