Your search did not match any results.

Overview

The TabPanel UI component includes both the Tabs and MultiView components. The TabPanel automatically synchronizes the selected tab with the currently displayed view (and vice versa).

To get started with the DevExtreme TabPanel component, refer to the following step-by-step tutorial: Getting Started with TabPanel.

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 TabPanel features used.
Backend API
<template> <div class="tabpanel-demo"> <div class="widget-container"> <DxTabPanel width="100%" height="418" item-template="tabPanelItem" :animation-enabled="true" :swipe-enabled="true" :data-source="dataSource" :tabs-position="tabsPosition" :styling-mode="stylingMode" :icon-position="iconPosition" > <template #tabPanelItem="{ data }"> <TabPanelItem :tasks="data.tasks" /> </template> </DxTabPanel> </div> <div class="options"> <div class="caption">Options</div> <div class="option"> <div class="option-label">Tab position</div> <DxSelectBox v-model:value="tabsPosition" :input-attr="tabsPositionsSelectBoxLabel" :items="tabsPositions" /> </div> <div class="option"> <div class="option-label">Styling mode</div> <DxSelectBox v-model:value="stylingMode" :input-attr="stylingModesSelectBoxLabel" :items="stylingModes" /> </div> <div class="option"> <div class="option-label">Icon position</div> <DxSelectBox v-model:value="iconPosition" :input-attr="iconPositionsSelectBoxLabel" :items="iconPositions" /> </div> </div> </div> </template> <script setup lang="ts"> import { ref } from 'vue'; import DxTabPanel from 'devextreme-vue/tab-panel'; import DxSelectBox from 'devextreme-vue/select-box'; import TabPanelItem from './TabPanelItem.vue'; import { tabsPositionsSelectBoxLabel, tabsPositions, stylingModesSelectBoxLabel, stylingModes, iconPositionsSelectBoxLabel, iconPositions, dataSource, } from './data.ts'; const tabsPosition = ref(tabsPositions[0]); const stylingMode = ref(stylingModes[0]); const iconPosition = ref(iconPositions[0]); </script> <style> .tabpanel-demo { display: flex; height: 100%; } .widget-container { display: flex; justify-content: center; flex-grow: 1; min-width: 360px; padding: 16px 32px; } .tabpanel-demo .dx-tabpanel { background-color: var(--dx-component-color-bg); } .dx-theme-material .widget-container { background-color: rgba(191, 191, 191, 0.15); } .dx-tabpanel-tabs-position-left .dx-tabpanel-container, .dx-tabpanel-tabs-position-right .dx-tabpanel-container { width: 0; } .dx-viewport:not(.dx-theme-generic) .dx-tabpanel { border-radius: 8px; overflow: clip; } .dx-tabs-vertical { min-width: 120px; } .options { display: inline-flex; flex-direction: column; flex-shrink: 0; box-sizing: border-box; width: 272px; padding: 20px; background-color: rgba(191, 191, 191, 0.15); } .caption { font-weight: 500; font-size: 18px; } .option { margin-top: 20px; } </style>
<template> <div> <div class="tabpanel-item"> <TaskItem v-for="(task, index) in tasks" :key="index" :task="task" /> </div> </div> </template> <script setup lang="ts"> import TaskItem from './TaskItem.vue'; withDefaults(defineProps<{ tasks?: Record<string, any>[] }>(), { tasks: () => [], }); </script> <style> .tabpanel-item { display: flex; flex-direction: column; gap: 12px; padding: 24px; } </style>
<template> <div :class="['task-item', `task-item-priority-${task.priority}`]"> <span class="task-item-text"> {{ task.text }} </span> <span class="task-item-info"> {{ task.date }} by {{ task.assignedBy }} </span> <i class="task-item-pseudo-button dx-icon dx-icon-overflow"/> </div> </template> <script setup lang="ts"> withDefaults(defineProps<{ task?: Record<string, any> }>(), { task: () => ({}), }); </script> <style> .task-item { position: relative; display: flex; flex-direction: column; justify-content: center; width: 100%; height: 50px; padding: 8px 12px 8px 8px; border-radius: 4px; box-shadow: 0 1px 4px 0 rgba(0, 0, 0, 0.15); } .task-item::before { content: ""; position: absolute; top: 8px; left: 6px; bottom: 8px; width: 3px; border-radius: 4px; } .task-item-priority-high::before { background-color: #e1bee7; } .task-item-priority-medium::before { background-color: #ffe0b2; } .task-item-priority-low::before { background-color: #c8e6c9; } .task-item-text, .task-item-info { margin: 0; padding: 0 24px 0 16px; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; } .task-item-info { font-size: 12px; opacity: 0.6; } .task-item-pseudo-button { position: absolute; right: 8px; top: 50%; font-size: 18px; transform: translateY(-50%); cursor: pointer; opacity: 0.6; } .dx-color-scheme-contrast .task-item { border: 1px solid #fff; } .dx-theme-fluent.dx-color-scheme-blue-dark .task-item { background-color: #1f1f1f; } </style>
window.exports = window.exports || {}; window.config = { transpiler: 'plugin-babel', meta: { '*.vue': { loader: 'vue-loader', }, '*.ts': { loader: 'demo-ts-loader', }, '*.svg': { loader: 'svg-loader', }, 'devextreme/time_zone_utils.js': { 'esModule': true, }, 'devextreme/localization.js': { 'esModule': true, }, 'devextreme/viz/palette.js': { 'esModule': true, }, }, paths: { 'root:': '../../../../', 'npm:': 'https://unpkg.com/', }, map: { 'vue': 'npm:vue@3.2.47/dist/vue.esm-browser.js', 'vue-loader': 'npm:dx-systemjs-vue-browser@1.1.1/index.js', 'demo-ts-loader': 'root:utils/demo-ts-loader.js', 'svg-loader': 'root:utils/svg-loader.js', 'mitt': 'npm:mitt/dist/mitt.umd.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.3/cjs', 'devextreme-vue': 'npm:devextreme-vue@24.1.3/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.8/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', '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-vue': { main: 'index.js', }, 'devextreme': { defaultExtension: 'js', }, 'devextreme/events/utils': { main: 'index', }, '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, }, }; System.config(window.config);
export const tabsPositionsSelectBoxLabel = { 'aria-label': 'Tab position' }; export const tabsPositions = [ 'left', 'top', 'right', 'bottom', ]; export const stylingModesSelectBoxLabel = { 'aria-label': 'Styling mode' }; export const stylingModes = [ 'secondary', 'primary', ]; export const iconPositionsSelectBoxLabel = { 'aria-label': 'Icon positions' }; export const iconPositions = [ 'top', 'start', 'end', 'bottom', ]; const tasks = [ { status: 'Not Started', priority: 'high', text: 'Revenue Projections', date: '2023/09/16', assignedBy: 'John Heart', }, { status: 'Not Started', priority: 'high', text: 'New Brochures', date: '2023/09/16', assignedBy: 'Samantha Bright', }, { status: 'Not Started', priority: 'medium', text: 'Training', date: '2023/09/16', assignedBy: 'Arthur Miller', }, { status: 'Not Started', priority: 'medium', text: 'NDA', date: '2023/09/16', assignedBy: 'Robert Reagan', }, { status: 'Not Started', priority: 'low', text: 'Health Insurance', date: '2023/09/16', assignedBy: 'Greta Sims', }, { status: 'Help Needed', priority: 'low', text: 'TV Recall', date: '2023/09/16', assignedBy: 'Brett Wade', }, { status: 'Help Needed', priority: 'low', text: 'Recall and Refund Forms', date: '2023/09/16', assignedBy: 'Sandra Johnson', }, { status: 'Help Needed', priority: 'high', text: 'Shippers', date: '2023/09/16', assignedBy: 'Ed Holmes', }, { status: 'Help Needed', priority: 'medium', text: 'Hardware Upgrade', date: '2023/09/16', assignedBy: 'Barb Banks', }, { status: 'In Progress', priority: 'medium', text: 'Online Sales', date: '2023/09/16', assignedBy: 'Cindy Stanwick', }, { status: 'In Progress', priority: 'medium', text: 'New Website Design', date: '2023/09/16', assignedBy: 'Sammy Hill', }, { status: 'In Progress', priority: 'low', text: 'Bandwidth Increase', date: '2023/09/16', assignedBy: 'Davey Jones', }, { status: 'In Progress', priority: 'medium', text: 'Support', date: '2023/09/16', assignedBy: 'Victor Norris', }, { status: 'In Progress', priority: 'low', text: 'Training Material', date: '2023/09/16', assignedBy: 'John Heart', }, { status: 'Deferred', priority: 'medium', text: 'New Database', date: '2023/09/16', assignedBy: 'Samantha Bright', }, { status: 'Deferred', priority: 'high', text: 'Automation Server', date: '2023/09/16', assignedBy: 'Arthur Miller', }, { status: 'Deferred', priority: 'medium', text: 'Retail Sales', date: '2023/09/16', assignedBy: 'Robert Reagan', }, { status: 'Deferred', priority: 'medium', text: 'Shipping Labels', date: '2023/09/16', assignedBy: 'Greta Sims', }, { status: 'Rejected', priority: 'high', text: 'Schedule Meeting with Sales Team', date: '2023/09/16', assignedBy: 'Sandra Johnson', }, { status: 'Rejected', priority: 'medium', text: 'Confirm Availability for Sales Meeting', date: '2023/09/16', assignedBy: 'Ed Holmes', }, { status: 'Rejected', priority: 'medium', text: 'Reschedule Sales Team Meeting', date: '2023/09/16', assignedBy: 'Barb Banks', }, { status: 'Rejected', priority: 'high', text: 'Update Database with New Leads', date: '2023/09/16', assignedBy: 'Kevin Carter', }, { status: 'Rejected', priority: 'low', text: 'Send Territory Sales Breakdown', date: '2023/09/16', assignedBy: 'Cindy Stanwick', }, { status: 'Completed', priority: 'medium', text: 'Territory Sales Breakdown Report', date: '2023/09/16', assignedBy: 'Sammy Hill', }, { status: 'Completed', priority: 'low', text: 'Return Merchandise Report', date: '2023/09/16', assignedBy: 'Davey Jones', }, { status: 'Completed', priority: 'high', text: 'Staff Productivity Report', date: '2023/09/16', assignedBy: 'Victor Norris', }, { status: 'Completed', priority: 'medium', text: 'Review HR Budget Company Wide', date: '2023/09/16', assignedBy: 'Mary Stern', }, ]; export const dataSource = [ { icon: 'description', title: 'Not Started', tasks: tasks.filter((item) => item.status === 'Not Started'), }, { icon: 'taskhelpneeded', title: 'Help Needed', tasks: tasks.filter((item) => item.status === 'Help Needed'), }, { icon: 'taskinprogress', title: 'In Progress', tasks: tasks.filter((item) => item.status === 'In Progress'), }, { icon: 'taskstop', title: 'Deferred', tasks: tasks.filter((item) => item.status === 'Deferred'), }, { icon: 'taskrejected', title: 'Rejected', tasks: tasks.filter((item) => item.status === 'Rejected'), }, { icon: 'taskcomplete', title: 'Completed', tasks: tasks.filter((item) => item.status === 'Completed'), }, ];
import { createApp } from 'vue'; import App from './App.vue'; createApp(App).mount('#app');
<!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.3/css/dx.light.css" /> <script src="https://unpkg.com/typescript@4.9.5/lib/typescript.js"></script> <script type="module"> import * as vueCompilerSFC from "https://unpkg.com/@vue/compiler-sfc@3.4.16/dist/compiler-sfc.esm-browser.js"; window.vueCompilerSFC = vueCompilerSFC; </script> <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.ts"); </script> </head> <body class="dx-viewport"> <div class="demo-container"> <div id="app"> </div> </div> </body> </html>

Generate Similar Tabs Based on a Data Source

To generate similar tabs and views, bind the TabPanel to data (using the items or dataSource property). Both these properties can work with local arrays, but dataSource also accepts a DataSource object. You can use this object if you need to process the local array or fetch the array from a remote data source. In this demo, the dataSource property is set to a local array.

Each object in the items[] or dataSource array can contain predefined fields, such as title or icon (see the items[] section for the full list). The TabPanel automatically recognizes these fields and creates the default tab and view appearance based on them.

Customize Tab Contents and Appearance

You can initialize tab contents (text, icons and badges) with values from underlying data objects.

Use the drop-down editors on the right to change tab position, styling mode, and icon position.