The group paging functionality allows you to load groups on demand and page through the groups at the same time.
By default, the groups are rendered collapsed and each row signifies one item from the page. When you expand a group row the grid inserts new rows to the current page or moves them to the next one if they do not fit the pageSize followed by the rest of the group rows.
To enable group paging, use the
group-paging method as part of the data source configuration, add a
group and a
page-size to see the result.
<kendo-grid name="grid" height="550"> <datasource type="DataSourceTagHelperType.Ajax" page-size="20" group-paging="true"> <groups> <group direction="asc" field="Country"> </group> </groups>
Group paging can be used with virtual scrolling. This further improves the performance because the grid only renders as many rows as its page size. When a group row is expanded, the grid rows content is refreshed to show the new rows within the current page.
All limitations of the virtual scrolling functionality apply.
When you use group paging with paging, the grid pager updates its total based on the current number of rows. Two kinds of paging occur:
- You can page the grouped rows available on other pages.
- You can expand a group thus inserting new rows in the total. The new rows precede the rest of the group rows and other items in the view.
data source types use server operations by default. To facilitate the group paging functionality, the grid data source sends the following additional parameters:
groupPaging. When a row is expanded, one or two requests will be issued.
- If the currently expanded row does not have subgroups, only one request is sent with the
filterparameter containing the group and subgroup value for which the items are requested.
- If the currently expanded row has subgroups, an additional request is sent with the
includeSubGroupCountparameter prompting that the response must include the total of items in the sub group
The expanded state of groups is preserved during paging only, but not if sort or filter are applied.
- The group paging functionality is not supported for endless scrolling enabled grids.
- If using in combination with virtual scrolling, all limitations of the virtual scrolling functionality apply.
- Group paging is not compatible with SignalR binding