Templates
This demo illustrates the use of templates in TabPanel. If your data objects contain custom fields, you need to specify the itemTitleRender/itemTitleComponent and itemRender/itemComponent that define how to display the fields in tabs and views.
If you want each tab and view to have differently structured content, define individual renders. To do this, assign an array of objects to the items[] or dataSource property and specify the tabRender/tabComponent and render/component properties in each object. This use case is illustrated in the following tutorial: Getting Started with TabPanel.
Use the following properties to configure user navigation between tabs:
-
swipeEnabled
Defines whether to switch between views with a swipe gesture. -
loop
Specifies whether to loop views. -
animationEnabled
Specifies whether to animate transition between views.
You can switch the checkboxes below the TabPanel to change the loop, animationEnabled, and swipeEnabled property values.
Feel free to share demo-related thoughts here.
If you have technical questions, please create a support ticket in the DevExpress Support Center.
Thank you for the feedback!
If you have technical questions, please create a support ticket in the DevExpress Support Center.
Backend API
import React, { useCallback, useState } from 'react';
import CheckBox, { CheckBoxTypes } from 'devextreme-react/check-box';
import TabPanel, { TabPanelTypes } from 'devextreme-react/tab-panel';
import { multiViewItems as companies } from './data.ts';
import CompanyItem from './CompanyItem.tsx';
const itemTitleRender = (company) => <span>{company.CompanyName}</span>;
const App = () => {
const [animationEnabled, setAnimationEnabled] = useState(true);
const [swipeEnabled, setSwipeEnabled] = useState(true);
const [loop, setLoop] = useState(false);
const [selectedIndex, setSelectedIndex] = useState(0);
const onSelectionChanged = useCallback((args: TabPanelTypes.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]);
const onSwipeEnabledChanged = useCallback((args: CheckBoxTypes.ValueChangedEvent) => {
setSwipeEnabled(args.value);
}, [setSwipeEnabled]);
return (
<div>
<TabPanel
height={260}
dataSource={companies}
selectedIndex={selectedIndex}
onOptionChanged={onSelectionChanged}
loop={loop}
itemTitleRender={itemTitleRender}
itemComponent={CompanyItem}
animationEnabled={animationEnabled}
swipeEnabled={swipeEnabled}
/>
<div className="item-box">
Item <span>{selectedIndex + 1}</span> of <span>{companies.length}</span>
</div>
<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 className="option">
<CheckBox
value={swipeEnabled}
onValueChanged={onSwipeEnabledChanged}
text="Swipe enabled"
/>
</div>
</div>
</div>
);
};
export default App;
import React, { useCallback, useState } from 'react';
import CheckBox from 'devextreme-react/check-box';
import TabPanel from 'devextreme-react/tab-panel';
import { multiViewItems as companies } from './data.js';
import CompanyItem from './CompanyItem.js';
const itemTitleRender = (company) => <span>{company.CompanyName}</span>;
const App = () => {
const [animationEnabled, setAnimationEnabled] = useState(true);
const [swipeEnabled, setSwipeEnabled] = 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],
);
const onSwipeEnabledChanged = useCallback(
(args) => {
setSwipeEnabled(args.value);
},
[setSwipeEnabled],
);
return (
<div>
<TabPanel
height={260}
dataSource={companies}
selectedIndex={selectedIndex}
onOptionChanged={onSelectionChanged}
loop={loop}
itemTitleRender={itemTitleRender}
itemComponent={CompanyItem}
animationEnabled={animationEnabled}
swipeEnabled={swipeEnabled}
/>
<div className="item-box">
Item <span>{selectedIndex + 1}</span> of <span>{companies.length}</span>
</div>
<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 className="option">
<CheckBox
value={swipeEnabled}
onValueChanged={onSwipeEnabledChanged}
text="Swipe enabled"
/>
</div>
</div>
</div>
);
};
export default App;
import React from 'react';
function CompanyItem({ data }) {
const company = data;
return (
<div>
<div className="tabpanel-item">
<div>
<p>
<span>{ company.Address }</span>
</p>
<p>
<span><b>{ company.City }</b>, </span>
<span>{ company.State } </span>
<span>{ company.Zipcode }</span>
</p>
</div>
<div>
<p>
Phone: <b>{ company.Phone }</b>
</p>
<p>
Fax: <b>{ company.Fax }</b>
</p>
<p>
Website: <a
href={company.Website}
rel="noreferrer"
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,
},
},
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@23.2.5/cjs',
'devextreme-react': 'npm:devextreme-react@23.2.5/cjs',
'jszip': 'npm:jszip@3.10.1/dist/jszip.min.js',
'devextreme-quill': 'npm:devextreme-quill@1.6.4/dist/dx-quill.min.js',
'devexpress-diagram': 'npm:devexpress-diagram@2.2.5/dist/dx-diagram.js',
'devexpress-gantt': 'npm:devexpress-gantt@4.1.51/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@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.4/standalone.js',
'prettier/parser-html': 'npm:prettier@2.8.4/parser-html.js',
},
packages: {
'devextreme': {
defaultExtension: 'js',
},
'devextreme-react': {
main: 'index.js',
},
'devextreme/events/utils': {
main: 'index',
},
'devextreme/localization/messages': {
format: 'json',
defaultExtension: '',
},
'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="tabpanel-item">
<div>
<p>
<span>{company.Address}</span>
</p>
<p>
<span>
<b>{company.City}</b>,
</span>
<span>{company.State} </span>
<span>{company.Zipcode}</span>
</p>
</div>
<div>
<p>
Phone: <b>{company.Phone}</b>
</p>
<p>
Fax: <b>{company.Fax}</b>
</p>
<p>
Website:{' '}
<a
href={company.Website}
rel="noreferrer"
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>
<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=1.0" />
<link rel="stylesheet" type="text/css" href="https://cdn3.devexpress.com/jslib/23.2.5/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>
.tabpanel-item {
height: 200px;
user-select: none;
padding-left: 25px;
padding-top: 55px;
}
.mobile .tabpanel-item {
padding-top: 10px;
}
.tabpanel-item > div {
float: left;
padding: 0 85px 10px 10px;
}
.tabpanel-item p {
font-size: 16px;
margin: 0;
}
.item-box {
font-size: 16px;
margin: 15px 0 45px 10px;
}
.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;
}