Task Template
The DevExtreme JavaScript Gantt templates help customize the layout and appearance of individual task elements. Templates allow you to mix HTML code with any DevExtreme JavaScript component - and position desired elements within the container. In this demo, a template is used to display images within tasks and change their background color.
Implementation: Use the taskContentTemplate template to customize and align task information within the template container. For each task, use the item property to obtain task information (title, resource, progress) and wrap it into div elements. Then, apply CSS styles to these div elements and place them into the container.
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
<template>
<div id="form-demo">
<div class="widget-container">
<DxGantt
:task-list-width="500"
:height="700"
scale-type="days"
:task-content-template="taskContentTemplate"
>
<DxTasks :data-source="tasks"/>
<DxDependencies :data-source="dependencies"/>
<DxResources :data-source="resources"/>
<DxResourceAssignments :data-source="resourceAssignments"/>
<DxEditing :enabled="true"/>
<DxColumn
:width="300"
data-field="title"
caption="Subject"
/>
<DxColumn
data-field="start"
caption="Start Date"
/>
<DxColumn
data-field="end"
caption="End Date"
/>
<template #taskContentTemplate="{ data: item }">
<div
class="custom-task"
:class="getTaskColor(item.taskData.id)"
:style="{width: item.taskSize.width + 'px'}"
>
<div class="custom-task-img-wrapper">
<img
class="custom-task-img"
:src="getImagePath(item.taskData.id)"
>
</div>
<div class="custom-task-wrapper">
<div class="custom-task-title">{{ item.taskData.title }}</div>
<div class="custom-task-row">{{ item.taskResources[0].text }}</div>
</div>
<div
class="custom-task-progress"
:style="{width: item.taskData.progress + '%'}"
/>
</div>
</template>
</DxGantt>
</div>
</div>
</template>
<script>
import {
DxGantt,
DxTasks,
DxDependencies,
DxResources,
DxResourceAssignments,
DxColumn,
DxEditing,
} from 'devextreme-vue/gantt';
import {
tasks,
dependencies,
resources,
resourceAssignments,
} from './data.js';
export default {
components: {
DxGantt,
DxTasks,
DxDependencies,
DxResources,
DxResourceAssignments,
DxColumn,
DxEditing,
},
data() {
return {
tasks,
dependencies,
resources,
resourceAssignments,
};
},
methods: {
getImagePath(taskId) {
const imgPath = '../../../../images/employees';
let img = taskId < 10 ? `0${taskId}` : taskId;
img = `${imgPath}/${img}.png`;
return img;
},
getTaskColor(taskId) {
const color = taskId % 6;
return `custom-task-color-${color}`;
},
},
};
</script>
<style>
#gantt {
height: 700px;
}
.custom-task-color-0 {
background-color: #5c57c9;
}
.custom-task-color-1 {
background-color: #35b86b;
}
.custom-task-color-2 {
background-color: #4796ce;
}
.custom-task-color-3 {
background-color: #ce4776;
}
.custom-task-color-4 {
background-color: #ce5b47;
}
.custom-task-color-5 {
background-color: #f78119;
}
.custom-task-color-6 {
background-color: #9f47ce;
}
.custom-task {
max-height: 48px;
height: 100%;
display: block;
overflow: hidden;
}
.custom-task-wrapper {
padding: 8px;
color: #fff;
}
.custom-task-wrapper > * {
display: block;
overflow: hidden;
text-overflow: ellipsis;
}
.custom-task-img-wrapper {
float: left;
width: 32px;
height: 32px;
border-radius: 50%;
margin: 8px;
background-color: #fff;
overflow: hidden;
}
.custom-task-img {
width: 32px;
}
.custom-task-title {
font-weight: 600;
font-size: 13px;
}
.custom-task-row {
font-size: 11px;
}
.custom-task-progress {
position: absolute;
left: 0;
bottom: 0;
width: 0%;
height: 4px;
background: rgba(0, 0, 0, 0.3);
}
.dx-gantt .dx-row {
height: 63px;
}
</style>
import { createApp } from 'vue';
import App from './App.vue';
createApp(App).mount('#app');
<!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.1.5/css/dx.light.css" />
<link rel="stylesheet" type="text/css" href="https://cdn3.devexpress.com/jslib/23.1.5/css/dx-gantt.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.js");
</script>
</head>
<body class="dx-viewport">
<div class="demo-container">
<div id="app"> </div>
</div>
</body>
</html>
const currentDate = new Date(Date.now());
const month = currentDate.getMonth();
const year = currentDate.getFullYear();
export const tasks = [{
id: 1,
parentId: 0,
title: 'Analysis/Software Requirements',
start: new Date(year, month, 1),
end: new Date(year, month, 28),
progress: 31,
}, {
id: 2,
parentId: 1,
title: 'Conduct needs analysis',
start: new Date(year, month, 1),
end: new Date(year, month, 3),
progress: 15,
}, {
id: 3,
parentId: 1,
title: 'Draft preliminary software specifications',
start: new Date(year, month, 3),
end: new Date(year, month, 5),
progress: 30,
}, {
id: 4,
parentId: 1,
title: 'Review software specifications/budget with team',
start: new Date(year, month, 4),
end: new Date(year, month, 6),
progress: 60,
}, {
id: 5,
parentId: 1,
title: 'Incorporate feedback on software specifications',
start: new Date(year, month, 6),
end: new Date(year, month, 8),
progress: 45,
}, {
id: 6,
parentId: 1,
title: 'Develop delivery timeline',
start: new Date(year, month, 8),
end: new Date(year, month, 14),
progress: 15,
}, {
id: 7,
parentId: 1,
title: 'Obtain approvals to proceed (concept, timeline, budget)',
start: new Date(year, month, 14),
end: new Date(year, month, 20),
progress: 15,
}, {
id: 8,
parentId: 1,
title: 'Draft preliminary software specifications',
start: new Date(year, month, 20),
end: new Date(year, month, 25),
progress: 0,
}, {
id: 9,
parentId: 1,
title: 'Secure required resources',
start: new Date(year, month, 25),
end: new Date(year, month, 28),
progress: 0,
}];
export const dependencies = [{
id: 1,
predecessorId: 2,
successorId: 3,
type: 0,
}, {
id: 2,
predecessorId: 3,
successorId: 4,
type: 0,
}, {
id: 3,
predecessorId: 4,
successorId: 5,
type: 0,
}, {
id: 4,
predecessorId: 5,
successorId: 6,
type: 0,
}, {
id: 5,
predecessorId: 6,
successorId: 7,
type: 0,
}, {
id: 6,
predecessorId: 7,
successorId: 8,
type: 0,
}, {
id: 7,
predecessorId: 8,
successorId: 9,
type: 0,
}];
export const resources = [{
id: 1,
text: 'John Heart',
}, {
id: 2,
text: 'Paul Peyton',
}, {
id: 3,
text: 'Robert Reagan',
}, {
id: 4,
text: 'Greta Sims',
}, {
id: 5,
text: 'Brett Wade',
}, {
id: 6,
text: 'Sandra Johnson',
}, {
id: 7,
text: 'Kevin Carter',
}, {
id: 8,
text: 'Cynthia Stanwick',
}, {
id: 9,
text: 'Olivia Samuelson',
}];
export const resourceAssignments = [{
id: 0,
taskId: 1,
resourceId: 1,
}, {
id: 1,
taskId: 2,
resourceId: 2,
}, {
id: 2,
taskId: 3,
resourceId: 3,
}, {
id: 3,
taskId: 4,
resourceId: 4,
}, {
id: 4,
taskId: 5,
resourceId: 5,
}, {
id: 5,
taskId: 6,
resourceId: 6,
}, {
id: 6,
taskId: 7,
resourceId: 7,
}, {
id: 7,
taskId: 8,
resourceId: 8,
}, {
id: 8,
taskId: 9,
resourceId: 9,
}];
window.exports = window.exports || {};
window.config = {
transpiler: 'plugin-babel',
meta: {
'*.vue': {
loader: 'vue-loader',
},
'*.ts': {
loader: 'demo-ts-loader',
},
'*.svg': {
loader: 'svg-loader',
},
'devextreme/localization.js': {
'esModule': true,
},
},
paths: {
'root:': '../../../../../',
'npm:': 'https://unpkg.com/',
},
map: {
'vue': 'npm:vue@3.3.4/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@23.1.6/cjs',
'devextreme-vue': 'npm:devextreme-vue@23.1.6',
'jszip': 'npm:jszip@3.7.1/dist/jszip.min.js',
'devextreme-quill': 'npm:devextreme-quill@1.6.2/dist/dx-quill.min.js',
'devexpress-diagram': 'npm:devexpress-diagram@2.2.2/dist/dx-diagram.js',
'devexpress-gantt': 'npm:devexpress-gantt@4.1.49/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',
'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-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.12/inferno/package.json',
],
babelOptions: {
sourceMaps: false,
stage0: true,
},
};
System.config(window.config);