Data Grid - Pagination
Through pagination, a segment of data can be viewed from the assigned data source.
By default, the MIT
DataGrid displays the rows with pagination, and up to 100 rows per page.
On the other hand, the commercial
DataGridPro component displays, by default, all the rows with infinite scrolling (and virtualization) and without the 100 rows per page limitation. You need to set the
pagination prop to enable the pagination feature in such a case.
- The default page size is
100, you can change this value with the
- You can configure the possible page size the user can choose from with the
While the previous demos show how the pagination can be uncontrolled, the active page can be controlled with the
autoPageSize prop allows to auto-scale the
pageSize to match the container height and the max number of rows that can be displayed without a vertical scroll bar.
By default, this feature is off.
By default, pagination works on the client-side.
To switch it to server-side, set
You also need to set the
rowCount prop so that the grid knows the total number of pages.
Finally, you need to handle the
onPageChange callback to load the rows for the corresponding page.
You can adapt the pagination for your cursor-based pagination. To do so, you just have to keep track of the next cursor associated with each page you fetched.
You can customize the rendering of the pagination in the footer following the component section of the documentation.
DataGrid component can display up to 100 rows per page.
DataGridPro component removes this limitation.
The following demo displays 200 rows per page:
The grid exposes a set of methods that enables all of these features using the imperative apiRef.
⚠️ Only use this API when you have no alternative. Always start from the declarative API that the grid exposes.
setPageSize: Set the number of rows in one page.
setPage: Set the displayed page.
onPageChange: Callback fired after a new page has been displayed.
onPageSizeChange: Callback fired after the page size was changed.
Below is an example of how you can reset the page using the imperative