DevExtreme v24.1 is now available.

Explore our newest features/capabilities and share your thoughts with us.

Your search did not match any results.

React Data Grid - Record Paging

The DataGrid splits records into multiple pages. This technique helps optimize control performance: the client only needs to load and render one page at a time. Users can use a scroll bar or a pager to navigate between pages. This demo shows how to enable and customize the pager.

Backend API
import React, { useCallback, useState } from 'react'; import DataGrid, { Scrolling, Pager, Paging, DataGridTypes, } from 'devextreme-react/data-grid'; import SelectBox from 'devextreme-react/select-box'; import CheckBox from 'devextreme-react/check-box'; import { generateData, displayModeLabel } from './data.ts'; const displayModes = [{ text: 'Display Mode \'full\'', value: 'full' }, { text: 'Display Mode \'compact\'', value: 'compact' }]; const allowedPageSizes: (DataGridTypes.PagerPageSize | number)[] = [5, 10, 'all']; const data = generateData(100000); const customizeColumns = (columns: DataGridTypes.Column[]) => { columns[0].width = 70; }; const App = () => { const [displayMode, setDisplayMode] = useState<DataGridTypes.PagerDisplayMode>('full'); const [showPageSizeSelector, setShowPageSizeSelector] = useState(true); const [showInfo, setShowInfo] = useState(true); const [showNavButtons, setShowNavButtons] = useState(true); const displayModeChange = useCallback((value) => { setDisplayMode(value); }, []); const showPageSizeSelectorChange = useCallback((value) => { setShowPageSizeSelector(value); }, []); const showInfoChange = useCallback((value) => { setShowInfo(value); }, []); const showNavButtonsChange = useCallback((value) => { setShowNavButtons(value); }, []); const isCompactMode = useCallback(() => displayMode === 'compact', [displayMode]); return ( <div> <DataGrid id='gridContainer' dataSource={data} keyExpr="id" showBorders={true} customizeColumns={customizeColumns} > <Scrolling rowRenderingMode='virtual'></Scrolling> <Paging defaultPageSize={10} /> <Pager visible={true} allowedPageSizes={allowedPageSizes} displayMode={displayMode} showPageSizeSelector={showPageSizeSelector} showInfo={showInfo} showNavigationButtons={showNavButtons} /> </DataGrid> <div className='options'> <div className='caption'>Options</div> <div className='option-container'> <div className='option'> <SelectBox id='displayModes' items={displayModes} displayExpr='text' inputAttr={displayModeLabel} valueExpr='value' value={displayMode} onValueChange={displayModeChange} /> </div> <div className='option'> <CheckBox id='showPageSizes' text='Show Page Size Selector' value={showPageSizeSelector} onValueChange={showPageSizeSelectorChange} /> </div> <div className='option'> <CheckBox id='showInfo' text='Show Info Text' value={showInfo} onValueChange={showInfoChange} /> </div> <div className='option'> <CheckBox id='showNavButtons' text='Show Navigation Buttons' value={showNavButtons} onValueChange={showNavButtonsChange} disabled={isCompactMode()} /> </div> </div> </div> </div> ); }; export default App;
import React, { useCallback, useState } from 'react'; import DataGrid, { Scrolling, Pager, Paging } from 'devextreme-react/data-grid'; import SelectBox from 'devextreme-react/select-box'; import CheckBox from 'devextreme-react/check-box'; import { generateData, displayModeLabel } from './data.js'; const displayModes = [ { text: "Display Mode 'full'", value: 'full' }, { text: "Display Mode 'compact'", value: 'compact' }, ]; const allowedPageSizes = [5, 10, 'all']; const data = generateData(100000); const customizeColumns = (columns) => { columns[0].width = 70; }; const App = () => { const [displayMode, setDisplayMode] = useState('full'); const [showPageSizeSelector, setShowPageSizeSelector] = useState(true); const [showInfo, setShowInfo] = useState(true); const [showNavButtons, setShowNavButtons] = useState(true); const displayModeChange = useCallback((value) => { setDisplayMode(value); }, []); const showPageSizeSelectorChange = useCallback((value) => { setShowPageSizeSelector(value); }, []); const showInfoChange = useCallback((value) => { setShowInfo(value); }, []); const showNavButtonsChange = useCallback((value) => { setShowNavButtons(value); }, []); const isCompactMode = useCallback(() => displayMode === 'compact', [displayMode]); return ( <div> <DataGrid id="gridContainer" dataSource={data} keyExpr="id" showBorders={true} customizeColumns={customizeColumns} > <Scrolling rowRenderingMode="virtual"></Scrolling> <Paging defaultPageSize={10} /> <Pager visible={true} allowedPageSizes={allowedPageSizes} displayMode={displayMode} showPageSizeSelector={showPageSizeSelector} showInfo={showInfo} showNavigationButtons={showNavButtons} /> </DataGrid> <div className="options"> <div className="caption">Options</div> <div className="option-container"> <div className="option"> <SelectBox id="displayModes" items={displayModes} displayExpr="text" inputAttr={displayModeLabel} valueExpr="value" value={displayMode} onValueChange={displayModeChange} /> </div> <div className="option"> <CheckBox id="showPageSizes" text="Show Page Size Selector" value={showPageSizeSelector} onValueChange={showPageSizeSelectorChange} /> </div> <div className="option"> <CheckBox id="showInfo" text="Show Info Text" value={showInfo} onValueChange={showInfoChange} /> </div> <div className="option"> <CheckBox id="showNavButtons" text="Show Navigation Buttons" value={showNavButtons} onValueChange={showNavButtonsChange} disabled={isCompactMode()} /> </div> </div> </div> </div> ); }; export default App;
import React from 'react'; import ReactDOM from 'react-dom'; import App from './App.tsx'; ReactDOM.render( <App />, document.getElementById('app'), );
let s = 123456789; function random() { s = (1103515245 * s + 12345) % 2147483647; return s % (10 - 1); } export function generateData(count: number) { let i; const surnames = ['Smith', 'Johnson', 'Brown', 'Taylor', 'Anderson', 'Harris', 'Clark', 'Allen', 'Scott', 'Carter']; const names = ['James', 'John', 'Robert', 'Christopher', 'George', 'Mary', 'Nancy', 'Sandra', 'Michelle', 'Betty']; const gender = ['Male', 'Female']; const items: ({ id: number; firstName: string; lastName: string; gender: string; birthDate: Date; })[] = []; const startBirthDate = Date.parse('1/1/1975'); const endBirthDate = Date.parse('1/1/1992'); for (i = 0; i < count; i += 1) { const birthDate = new Date(startBirthDate + Math.floor( (random() * (endBirthDate - startBirthDate)) / 10, )); birthDate.setHours(12); const nameIndex = random(); const item = { id: i + 1, firstName: names[nameIndex], lastName: surnames[random()], gender: gender[Math.floor(nameIndex / 5)], birthDate, }; items.push(item); } return items; } export const displayModeLabel = { 'aria-label': 'Refresh Mode' };
window.exports = window.exports || {}; window.config = { transpiler: 'ts', typescriptOptions: { module: 'system', emitDecoratorMetadata: true, experimentalDecorators: true, jsx: 'react', }, meta: { 'react': { 'esModule': true, }, 'typescript': { 'exports': 'ts', }, 'devextreme/time_zone_utils.js': { 'esModule': true, }, 'devextreme/localization.js': { 'esModule': true, }, 'devextreme/viz/palette.js': { 'esModule': true, }, }, paths: { 'npm:': 'https://unpkg.com/', }, defaultExtension: 'js', map: { 'ts': 'npm:plugin-typescript@4.2.4/lib/plugin.js', 'typescript': 'npm:typescript@4.2.4/lib/typescript.js', 'react': 'npm:react@17.0.2/umd/react.development.js', 'react-dom': 'npm:react-dom@17.0.2/umd/react-dom.development.js', 'prop-types': 'npm:prop-types@15.8.1/prop-types.js', 'rrule': 'npm:rrule@2.6.4/dist/es5/rrule.js', 'luxon': 'npm:luxon@1.28.1/build/global/luxon.min.js', 'es6-object-assign': 'npm:es6-object-assign@1.1.0', 'devextreme': 'npm:devextreme@24.1.7/cjs', 'devextreme-react': 'npm:devextreme-react@24.1.7/cjs', 'jszip': 'npm:jszip@3.10.1/dist/jszip.min.js', 'devextreme-quill': 'npm:devextreme-quill@1.7.1/dist/dx-quill.min.js', 'devexpress-diagram': 'npm:devexpress-diagram@2.2.12/dist/dx-diagram.js', 'devexpress-gantt': 'npm:devexpress-gantt@4.1.56/dist/dx-gantt.js', '@devextreme/runtime': 'npm:@devextreme/runtime@3.0.13', 'inferno': 'npm:inferno@7.4.11/dist/inferno.min.js', 'inferno-compat': 'npm:inferno-compat/dist/inferno-compat.min.js', 'inferno-create-element': 'npm:inferno-create-element@7.4.11/dist/inferno-create-element.min.js', 'inferno-dom': 'npm:inferno-dom/dist/inferno-dom.min.js', 'inferno-hydrate': 'npm:inferno-hydrate@7.4.11/dist/inferno-hydrate.min.js', 'inferno-clone-vnode': 'npm:inferno-clone-vnode/dist/inferno-clone-vnode.min.js', 'inferno-create-class': 'npm:inferno-create-class/dist/inferno-create-class.min.js', 'inferno-extras': 'npm:inferno-extras/dist/inferno-extras.min.js', 'devextreme-cldr-data': 'npm:devextreme-cldr-data@1.0.3', // SystemJS plugins 'plugin-babel': 'npm:systemjs-plugin-babel@0.0.25/plugin-babel.js', 'systemjs-babel-build': 'npm:systemjs-plugin-babel@0.0.25/systemjs-babel-browser.js', // Prettier 'prettier/standalone': 'npm:prettier@2.8.8/standalone.js', 'prettier/parser-html': 'npm:prettier@2.8.8/parser-html.js', }, packages: { 'devextreme': { defaultExtension: 'js', }, 'devextreme-react': { main: 'index.js', }, 'devextreme/events/utils': { main: 'index', }, 'devextreme/localization/messages': { format: 'json', defaultExtension: 'json', }, 'devextreme/events': { main: 'index', }, 'es6-object-assign': { main: './index.js', defaultExtension: 'js', }, }, packageConfigPaths: [ 'npm:@devextreme/*/package.json', 'npm:@devextreme/runtime@3.0.13/inferno/package.json', ], babelOptions: { sourceMaps: false, stage0: true, react: true, }, }; System.config(window.config);
import React from 'react'; import ReactDOM from 'react-dom'; import App from './App.js'; ReactDOM.render(<App />, document.getElementById('app'));
let s = 123456789; function random() { s = (1103515245 * s + 12345) % 2147483647; return s % (10 - 1); } export function generateData(count) { let i; const surnames = [ 'Smith', 'Johnson', 'Brown', 'Taylor', 'Anderson', 'Harris', 'Clark', 'Allen', 'Scott', 'Carter', ]; const names = [ 'James', 'John', 'Robert', 'Christopher', 'George', 'Mary', 'Nancy', 'Sandra', 'Michelle', 'Betty', ]; const gender = ['Male', 'Female']; const items = []; const startBirthDate = Date.parse('1/1/1975'); const endBirthDate = Date.parse('1/1/1992'); for (i = 0; i < count; i += 1) { const birthDate = new Date( startBirthDate + Math.floor((random() * (endBirthDate - startBirthDate)) / 10), ); birthDate.setHours(12); const nameIndex = random(); const item = { id: i + 1, firstName: names[nameIndex], lastName: surnames[random()], gender: gender[Math.floor(nameIndex / 5)], birthDate, }; items.push(item); } return items; } export const displayModeLabel = { 'aria-label': 'Refresh Mode' };
<!DOCTYPE html> <html lang="en"> <head> <title>DevExtreme Demo</title> <meta http-equiv="X-UA-Compatible" content="IE=edge" /> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=5.0" /> <link rel="stylesheet" type="text/css" href="https://cdn3.devexpress.com/jslib/24.1.7/css/dx.light.css" /> <link rel="stylesheet" type="text/css" href="styles.css" /> <script src="https://unpkg.com/core-js@2.6.12/client/shim.min.js"></script> <script src="https://unpkg.com/systemjs@0.21.3/dist/system.js"></script> <script type="text/javascript" src="config.js"></script> <script type="text/javascript"> System.import("./index.tsx"); </script> </head> <body class="dx-viewport"> <div class="demo-container"> <div id="app"></div> </div> </body> </html>
#gridContainer { max-height: 800px; } .options { margin-top: 20px; padding: 20px; background-color: rgba(191, 191, 191, 0.15); position: relative; } .caption { font-size: 18px; font-weight: 500; } .option-container { display: flex; margin: 0 auto; justify-content: space-between; } .option { margin-top: 10px; display: flex; align-items: center; } .option-caption { white-space: nowrap; margin: 0 8px; }

The pager is configured in the pager object and contains the following elements:

  • Page navigator
    Enables page navigation.

  • Page size selector
    Changes the page size. To display this element, enable the showPageSizeSelector property. You can also define the allowedPageSizes and specify the initial pageSize in the paging object.

  • Page information
    Displays the current page number and total record count. To display page information, enable the showInfo property. You can also use the infoText property to customize the information text string.

The pager supports full, compact, and adaptive (default) display modes. In compact mode, the pager changes the appearance of the page navigator and page selector to use screen space more efficiently. In adaptive mode, the pager automatically chooses between the full and compact modes based on the DataGrid's width. Use the displayMode property to switch between modes.

In this demo, you can use the drop-down Display Mode menu to switch between full and compact display modes. You can also use the checkboxes to hide or display different pager elements. Note that when the pager is in compact mode, navigation buttons are always visible.