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.

TS JS

Backend API

import React, { useCallback, useState } from 'react'; import CheckBox, { type CheckBoxTypes } from 'devextreme-react/check-box'; import MultiView, { type MultiViewTypes } from 'devextreme-react/multi-view'; import { companies } from './data.ts'; import CompanyItem from './CompanyItem.tsx'; const App = () => { const [animationEnabled, setAnimationEnabled] = useState<boolean>(true); const [loop, setLoop] = useState<boolean>(false); const [selectedIndex, setSelectedIndex] = useState<number>(0); const onAnimationEnabledChanged = useCallback((args: CheckBoxTypes.ValueChangedEvent): void => { setAnimationEnabled(args.value); }, []); const onLoopChanged = useCallback((e: CheckBoxTypes.ValueChangedEvent): void => { setLoop(e.value); }, []); const onSelectionChanged = useCallback((e: MultiViewTypes.OptionChangedEvent): void => { if (e.name === 'selectedIndex') { setSelectedIndex(e.value); } }, []); 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 { 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 onAnimationEnabledChanged = useCallback((args) => { setAnimationEnabled(args.value); }, []); const onLoopChanged = useCallback((e) => { setLoop(e.value); }, []); const onSelectionChanged = useCallback((e) => { if (e.name === 'selectedIndex') { setSelectedIndex(e.value); } }, []); 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'; import type { Company } from './types.ts'; interface CompanyItemProps { data: Company; } function CompanyItem({ data }: CompanyItemProps) { const { CompanyName, City, State, Zipcode, Address, Phone, Fax, Website, } = data; return ( <div> <div className="multiview-item"> <div className="header">{ CompanyName }</div> <div> <p> <b>{ City } </b> (<span>{ State }</span>) </p> <p> <span>{ Zipcode } </span> <span>{ Address }</span> </p> </div> <div> <p> Phone: <b>{ Phone }</b> </p> <p> Fax: <b>{ Fax }</b> </p> <p> Website: <a href={Website} target="_blank"> { 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'), );

import type { Company } from './types.ts'; export const companies: Company[] = [{ 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', }];

export type Company = { ID: number; CompanyName: string; Address: string; City: string; State: string; Zipcode: number; Phone: string; Fax: string; Website: string; };

import React from 'react'; function CompanyItem({ data }) { const { CompanyName, City, State, Zipcode, Address, Phone, Fax, Website, } = data; return ( <div> <div className="multiview-item"> <div className="header">{CompanyName}</div> <div> <p> <b>{City} </b>(<span>{State}</span>) </p> <p> <span>{Zipcode} </span> <span>{Address}</span> </p> </div> <div> <p> Phone: <b>{Phone}</b> </p> <p> Fax: <b>{Fax}</b> </p> <p> Website:{' '} <a href={Website} target="_blank" > {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 companies = [ { 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/25.2.3/css/dx.light.css" /> <link rel="stylesheet" type="text/css" href="styles.css" /> <script src="https://cdn.jsdelivr.net/npm/core-js@2.6.12/client/shim.min.js"></script> <script src="https://cdn.jsdelivr.net/npm/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.