DevExtreme v24.2 is now available.

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

Your search did not match any results.

React Multi View

The MultiView component contains multiple views and allows users to switch between them. In this demo, swipe left or right to navigate through the views.

You can create view items in the items array, or load them from a dataSource. If you specify the dataSource structure as described in the items API section, the dataSource populates the component with view items. Otherwise, you need to specify an itemTemplate. This demo shows how to implement the latter scenario.

DevExtreme Accessibility Compliance
DevExtreme component libraries meet a variety of WCAG and Section 508 compliance standards. To assess this demo’s accessibility level, click the Run AXE® Validation button to launch the AXE® web accessibility evaluation tool.
All trademarks or registered trademarks are property of their respective owners. AXE® Terms of Use
The overall accessibility level of your application depends on the MultiView features used.
Backend API
import React, { useCallback, useState } from 'react'; import CheckBox, { CheckBoxTypes } from 'devextreme-react/check-box'; import MultiView, { MultiViewTypes } from 'devextreme-react/multi-view'; import { multiViewItems as companies } from './data.ts'; import CompanyItem from './CompanyItem.tsx'; const App = () => { const [animationEnabled, setAnimationEnabled] = useState(true); const [loop, setLoop] = useState(false); const [selectedIndex, setSelectedIndex] = useState(0); const onSelectionChanged = useCallback((args: MultiViewTypes.OptionChangedEvent) => { if (args.name === 'selectedIndex') { setSelectedIndex(args.value); } }, [setSelectedIndex]); const onLoopChanged = useCallback((args: CheckBoxTypes.ValueChangedEvent) => { setLoop(args.value); }, [setLoop]); const onAnimationEnabledChanged = useCallback((args: CheckBoxTypes.ValueChangedEvent) => { setAnimationEnabled(args.value); }, [setAnimationEnabled]); return ( <div id="multiview"> <div> Item <span> {selectedIndex + 1} </span> of <span> {companies.length} </span>: <i> Swipe the view horizontally to switch to the next view. </i> </div> <MultiView height={300} dataSource={companies} selectedIndex={selectedIndex} onOptionChanged={onSelectionChanged} loop={loop} itemComponent={CompanyItem} animationEnabled={animationEnabled} /> <div className="options"> <div className="caption">Options</div> <div className="option"> <CheckBox value={loop} onValueChanged={onLoopChanged} text="Loop enabled" /> </div> <div className="option"> <CheckBox value={animationEnabled} onValueChanged={onAnimationEnabledChanged} text="Animation enabled" /> </div> </div> </div> ); }; export default App;
import React, { useCallback, useState } from 'react'; import CheckBox from 'devextreme-react/check-box'; import MultiView from 'devextreme-react/multi-view'; import { multiViewItems as companies } from './data.js'; import CompanyItem from './CompanyItem.js'; const App = () => { const [animationEnabled, setAnimationEnabled] = useState(true); const [loop, setLoop] = useState(false); const [selectedIndex, setSelectedIndex] = useState(0); const onSelectionChanged = useCallback( (args) => { if (args.name === 'selectedIndex') { setSelectedIndex(args.value); } }, [setSelectedIndex], ); const onLoopChanged = useCallback( (args) => { setLoop(args.value); }, [setLoop], ); const onAnimationEnabledChanged = useCallback( (args) => { setAnimationEnabled(args.value); }, [setAnimationEnabled], ); return ( <div id="multiview"> <div> Item <span>{selectedIndex + 1}</span> of <span>{companies.length}</span>:{' '} <i>Swipe the view horizontally to switch to the next view.</i> </div> <MultiView height={300} dataSource={companies} selectedIndex={selectedIndex} onOptionChanged={onSelectionChanged} loop={loop} itemComponent={CompanyItem} animationEnabled={animationEnabled} /> <div className="options"> <div className="caption">Options</div> <div className="option"> <CheckBox value={loop} onValueChanged={onLoopChanged} text="Loop enabled" /> </div> <div className="option"> <CheckBox value={animationEnabled} onValueChanged={onAnimationEnabledChanged} text="Animation enabled" /> </div> </div> </div> ); }; export default App;
import React from 'react'; function CompanyItem({ data }) { const company = data; return ( <div> <div className="multiview-item"> <div className="header">{ company.CompanyName }</div> <div> <p> <b>{ company.City } </b> (<span>{ company.State }</span>) </p> <p> <span>{ company.Zipcode } </span> <span>{ company.Address }</span> </p> </div> <div> <p> Phone: <b>{ company.Phone }</b> </p> <p> Fax: <b>{ company.Fax }</b> </p> <p> Website: <a href={company.Website} target="_blank"> { company.Website } </a> </p> </div> </div> </div> ); } export default CompanyItem;
import React from 'react'; import ReactDOM from 'react-dom'; import App from './App.tsx'; ReactDOM.render( <App />, document.getElementById('app'), );
export const multiViewItems = [{ ID: 1, CompanyName: 'SuprMart', Address: '702 SW 8th Street', City: 'Bentonville', State: 'Arkansas', Zipcode: 72716, Phone: '(800) 555-2797', Fax: '(800) 555-2171', Website: 'http://www.nowebsitesupermart.dx', }, { ID: 2, CompanyName: "El'Depot", Address: '2455 Paces Ferry Road NW', City: 'Atlanta', State: 'Georgia', Zipcode: 30339, Phone: '(800) 595-3232', Fax: '(800) 595-3231', Website: 'http://www.nowebsitedepot.dx', }, { ID: 3, CompanyName: 'K&S Music', Address: '1000 Nicllet Mall', City: 'Minneapolis', State: 'Minnesota', Zipcode: 55403, Phone: '(612) 304-6073', Fax: '(612) 304-6074', Website: 'http://www.nowebsitemusic.dx', }, { ID: 4, CompanyName: 'Tom Club', Address: '999 Lake Drive', City: 'Issaquah', State: 'Washington', Zipcode: 98027, Phone: '(800) 955-2292', Fax: '(800) 955-2293', Website: 'http://www.nowebsitetomsclub.dx', }];
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, }, 'openai': { 'esModule': true, }, }, paths: { 'npm:': 'https://unpkg.com/', 'bundles:': '../../../../bundles/', 'externals:': '../../../../bundles/externals/', }, defaultExtension: 'js', map: { 'ts': 'npm:plugin-typescript@8.0.0/lib/plugin.js', 'typescript': 'npm:typescript@4.2.4/lib/typescript.js', 'jszip': 'npm:jszip@3.10.1/dist/jszip.min.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/prop-types.js', 'rrule': 'npm:rrule@2.6.4/dist/es5/rrule.js', 'luxon': 'npm:luxon@3.4.4/build/global/luxon.min.js', 'es6-object-assign': 'npm:es6-object-assign', 'devextreme': 'npm:devextreme@link:../../packages/devextreme/artifacts/npm/devextreme/cjs', 'devextreme-react': 'npm:devextreme-react@link:../../packages/devextreme-react/npm/cjs', 'devextreme-quill': 'npm:devextreme-quill@1.7.1/dist/dx-quill.min.js', 'devexpress-diagram': 'npm:devexpress-diagram@2.2.5/dist/dx-diagram.js', 'devexpress-gantt': 'npm:devexpress-gantt@4.1.54/dist/dx-gantt.js', '@devextreme/runtime': 'npm:@devextreme/runtime@3.0.12', '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/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.12/inferno/package.json', ], babelOptions: { sourceMaps: false, stage0: true, react: true, }, }; System.config(window.config);
import React from 'react'; function CompanyItem({ data }) { const company = data; return ( <div> <div className="multiview-item"> <div className="header">{company.CompanyName}</div> <div> <p> <b>{company.City} </b>(<span>{company.State}</span>) </p> <p> <span>{company.Zipcode} </span> <span>{company.Address}</span> </p> </div> <div> <p> Phone: <b>{company.Phone}</b> </p> <p> Fax: <b>{company.Fax}</b> </p> <p> Website:{' '} <a href={company.Website} target="_blank" > {company.Website} </a> </p> </div> </div> </div> ); } export default CompanyItem;
import React from 'react'; import ReactDOM from 'react-dom'; import App from './App.js'; ReactDOM.render(<App />, document.getElementById('app'));
export const multiViewItems = [ { ID: 1, CompanyName: 'SuprMart', Address: '702 SW 8th Street', City: 'Bentonville', State: 'Arkansas', Zipcode: 72716, Phone: '(800) 555-2797', Fax: '(800) 555-2171', Website: 'http://www.nowebsitesupermart.dx', }, { ID: 2, CompanyName: "El'Depot", Address: '2455 Paces Ferry Road NW', City: 'Atlanta', State: 'Georgia', Zipcode: 30339, Phone: '(800) 595-3232', Fax: '(800) 595-3231', Website: 'http://www.nowebsitedepot.dx', }, { ID: 3, CompanyName: 'K&S Music', Address: '1000 Nicllet Mall', City: 'Minneapolis', State: 'Minnesota', Zipcode: 55403, Phone: '(612) 304-6073', Fax: '(612) 304-6074', Website: 'http://www.nowebsitemusic.dx', }, { ID: 4, CompanyName: 'Tom Club', Address: '999 Lake Drive', City: 'Issaquah', State: 'Washington', Zipcode: 98027, Phone: '(800) 955-2292', Fax: '(800) 955-2293', Website: 'http://www.nowebsitetomsclub.dx', }, ];
<!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.2.3/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>
#multiview { margin-top: 25px; } .multiview-item { margin: 25px; user-select: none; border-top: 1px solid lightgray; border-bottom: 1px solid lightgray; padding: 20px 0 30px; } .multiview-item > div { padding-top: 20px; } #multiview > div:first-child { padding-left: 25px; } #multiview p, #multiview .header { margin: 0; } #multiview .header { font-size: 34px; padding-top: 0; } .options { padding: 20px; background-color: rgba(191, 191, 191, 0.15); margin-top: 20px; } .caption { font-size: 18px; font-weight: 500; } .option { margin-top: 10px; }

If you want users to scroll back to the first item after they swipe the last item, set the loop property to true. Specify the animationEnabled property to enable or disable the scroll animation.