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.
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
$(() => {
const taskItem = (task) => {
const className = `task-item task-item-priority-${task.priority}`;
return `
<div class="${className}">
<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"></i>
</div>
`;
};
const taskList = (tasks) => {
const list = tasks.reduce((accumulator, task) => `${accumulator} ${taskItem(task)}`, '');
return `
<div class="tabpanel-item">
${list}
</div>
`;
};
const tabPanel = $('#tabpanel').dxTabPanel({
dataSource,
width: '100%',
height: 418,
animationEnabled: true,
swipeEnabled: true,
tabsPosition: tabsPositions[0],
stylingMode: stylingModes[0],
iconPosition: iconPositions[0],
itemTemplate: ({ tasks }) => taskList(tasks),
}).dxTabPanel('instance');
$('#tabs-position-selectbox').dxSelectBox({
inputAttr: tabsPositionsSelectBoxLabel,
items: tabsPositions,
value: tabsPositions[0],
onValueChanged({ value }) {
tabPanel.option({ tabsPosition: value });
},
});
$('#styling-mode-selectbox').dxSelectBox({
inputAttr: stylingModesSelectBoxLabel,
items: stylingModes,
value: stylingModes[0],
onValueChanged({ value }) {
tabPanel.option({ stylingMode: value });
},
});
$('#icon-position-selectbox').dxSelectBox({
inputAttr: iconPositionsSelectBoxLabel,
items: iconPositions,
value: iconPositions[0],
onValueChanged({ value }) {
tabPanel.option({ iconPosition: value });
},
});
});
<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml" 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" />
<script src="https://ajax.googleapis.com/ajax/libs/jquery/3.5.1/jquery.min.js"></script>
<script>window.jQuery || document.write(decodeURIComponent('%3Cscript src="js/jquery.min.js"%3E%3C/script%3E'))</script>
<link rel="stylesheet" type="text/css" href="https://cdn3.devexpress.com/jslib/24.1.7/css/dx.light.css" />
<script src="js/dx.all.js"></script>
<script src="data.js"></script>
<link rel="stylesheet" type="text/css" href="styles.css" />
<script src="index.js"></script>
</head>
<body class="dx-viewport">
<div class="demo-container">
<div class="tabpanel-demo">
<div class="widget-container">
<div id="tabpanel"></div>
</div>
<div class="options">
<div class="caption">Options</div>
<div class="option">
<div class="option-label">Tab position</div>
<div id="tabs-position-selectbox"></div>
</div>
<div class="option">
<div class="option-label">Styling mode</div>
<div id="styling-mode-selectbox"></div>
</div>
<div class="option">
<div class="option-label">Icon position</div>
<div id="icon-position-selectbox"></div>
</div>
</div>
</div>
</div>
</body>
</html>
.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;
}
.tabpanel-item {
display: flex;
flex-direction: column;
gap: 12px;
padding: 24px;
}
.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;
}
const tabsPositionsSelectBoxLabel = { 'aria-label': 'Tab position' };
const tabsPositions = [
'left',
'top',
'right',
'bottom',
];
const stylingModesSelectBoxLabel = { 'aria-label': 'Styling mode' };
const stylingModes = [
'secondary',
'primary',
];
const iconPositionsSelectBoxLabel = { 'aria-label': 'Icon positions' };
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',
},
];
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'),
},
];
Generate Similar Tabs Based on a Data Source
To generate similar tabs and views, bind the JavaScript 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 JavaScript 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.