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.
If you have technical questions, please create a support ticket in the DevExpress Support Center.
Thank you!
We appreciate your feedback.
We appreciate your feedback.
<div id="demo-container">
<div class="widget-container">
<dx-gantt
taskListWidth="500"
height="700"
scaleType="days"
taskContentTemplate="taskContentTemplate"
>
<dxo-tasks [dataSource]="tasks"></dxo-tasks>
<dxo-dependencies [dataSource]="dependencies"></dxo-dependencies>
<dxo-resources [dataSource]="resources"></dxo-resources>
<dxo-resource-assignments
[dataSource]="resourceAssignments"
></dxo-resource-assignments>
<dxi-column
dataField="title"
caption="Subject"
[width]="300"
></dxi-column>
<dxi-column
dataField="start"
caption="Start Date"
dataType="date"
></dxi-column>
<dxi-column
dataField="end"
caption="End Date"
dataType="date"
></dxi-column>
<dxo-editing [enabled]="true"></dxo-editing>
<div
*dxTemplate="let item of 'taskContentTemplate'"
class="custom-task {{ getTaskColor(item.taskData.id) }}"
style.width="{{ item.taskSize.width }}px"
>
<div class="custom-task-img-wrapper">
<img
class="custom-task-img"
attr.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>
</div>
</dx-gantt>
</div>
</div>
import { ViewEncapsulation } from '@angular/compiler/src/core';
import { NgModule, Component, enableProdMode } from '@angular/core';
import { BrowserModule } from '@angular/platform-browser';
import { platformBrowserDynamic } from '@angular/platform-browser-dynamic';
import { DxGanttModule, DxCheckBoxModule, DxSelectBoxModule } from 'devextreme-angular';
import {
Service, Task, Dependency, Resource, ResourceAssignment,
} from './app.service';
if (!/localhost/.test(document.location.host)) {
enableProdMode();
}
@Component({
selector: 'demo-app',
templateUrl: 'app/app.component.html',
styleUrls: ['app/app.component.css'],
providers: [Service],
preserveWhitespaces: true,
encapsulation: ViewEncapsulation.None,
})
export class AppComponent {
tasks: Task[];
dependencies: Dependency[];
resources: Resource[];
resourceAssignments: ResourceAssignment[];
constructor(service: Service) {
this.tasks = service.getTasks();
this.dependencies = service.getDependencies();
this.resources = service.getResources();
this.resourceAssignments = service.getResourceAssignments();
}
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}`;
}
}
@NgModule({
imports: [
BrowserModule,
DxGanttModule,
DxCheckBoxModule,
DxSelectBoxModule,
],
declarations: [AppComponent],
bootstrap: [AppComponent],
})
export class AppModule { }
platformBrowserDynamic().bootstrapModule(AppModule);
#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;
}
import { Injectable } from '@angular/core';
export class Task {
id: number;
parentId: number;
title: string;
start: Date;
end: Date;
progress: number;
}
export class Dependency {
id: number;
predecessorId: number;
successorId: number;
type: number;
}
export class Resource {
id: number;
text: string;
}
export class ResourceAssignment {
id: number;
taskId: number;
resourceId: number;
}
const currentDate: Date = new Date(Date.now());
const month: number = currentDate.getMonth();
const year: number = currentDate.getFullYear();
const tasks: Task[] = [{
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,
}];
const dependencies: Dependency[] = [{
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,
}];
const resources: Resource[] = [{
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',
}];
const resourceAssignments: ResourceAssignment[] = [{
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,
}];
@Injectable()
export class Service {
getTasks(): Task[] {
return tasks;
}
getDependencies(): Dependency[] {
return dependencies;
}
getResources(): Resource[] {
return resources;
}
getResourceAssignments(): ResourceAssignment[] {
return resourceAssignments;
}
}
// In real applications, you should not transpile code in the browser.
// You can see how to create your own application with Angular and DevExtreme here:
// https://js.devexpress.com/Documentation/Guide/Angular_Components/Getting_Started/Create_a_DevExtreme_Application/
window.config = {
transpiler: 'ts',
typescriptOptions: {
module: 'system',
emitDecoratorMetadata: true,
experimentalDecorators: true,
},
meta: {
'typescript': {
'exports': 'ts',
},
'devextreme/localization.js': {
'esModule': true,
},
},
paths: {
'npm:': 'https://unpkg.com/',
},
map: {
'ts': 'npm:plugin-typescript@4.2.4/lib/plugin.js',
'typescript': 'npm:typescript@4.2.4/lib/typescript.js',
'@angular/core': 'npm:@angular/core@12.2.17',
'@angular/platform-browser': 'npm:@angular/platform-browser@12.2.17',
'@angular/platform-browser-dynamic': 'npm:@angular/platform-browser-dynamic@12.2.17',
'@angular/forms': 'npm:@angular/forms@12.2.17',
'@angular/common': 'npm:@angular/common@12.2.17',
'@angular/compiler': 'npm:@angular/compiler@12.2.17',
'tslib': 'npm:tslib@2.3.1/tslib.js',
'rxjs': 'npm:rxjs@7.5.3/dist/bundles/rxjs.umd.js',
'rxjs/operators': 'npm:rxjs@7.5.3/dist/cjs/operators/index.js',
'rrule': 'npm:rrule@2.6.4/dist/es5/rrule.js',
'luxon': 'npm:luxon@1.28.0/build/global/luxon.min.js',
'es6-object-assign': 'npm:es6-object-assign@1.1.0',
'devextreme': 'npm:devextreme@22.2.6/cjs',
'devextreme/bundles/dx.all': 'npm:devextreme@22.2.6/bundles/dx.all.js',
'jszip': 'npm:jszip@3.7.1/dist/jszip.min.js',
'devextreme-quill': 'npm:devextreme-quill@1.5.20/dist/dx-quill.min.js',
'devexpress-diagram': 'npm:devexpress-diagram@2.1.72',
'devexpress-gantt': 'npm:devexpress-gantt@4.1.43',
'devextreme-angular': 'npm:devextreme-angular@22.2.6',
'@devextreme/runtime': 'npm:@devextreme/runtime@3.0.11',
'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',
// Prettier
'prettier/standalone': 'npm:prettier@2.8.4/standalone.js',
'prettier/parser-html': 'npm:prettier@2.8.4/parser-html.js',
},
packages: {
'app': {
main: './app.component.ts',
defaultExtension: 'ts',
},
'devextreme': {
defaultExtension: 'js',
},
'devextreme/events/utils': {
main: 'index',
},
'devextreme/events': {
main: 'index',
},
'es6-object-assign': {
main: './index.js',
defaultExtension: 'js',
},
'rxjs': {
defaultExtension: 'js',
},
'rxjs/operators': {
defaultExtension: 'js',
},
},
packageConfigPaths: [
'npm:@devextreme/*/package.json',
'npm:@devextreme/runtime@3.0.11/inferno/package.json',
'npm:@angular/*/package.json',
'npm:@angular/common@12.2.17/*/package.json',
'npm:rxjs@7.5.3/package.json',
'npm:rxjs@7.5.3/operators/package.json',
'npm:devextreme-angular@22.2.6/*/package.json',
'npm:devextreme-angular@22.2.6/ui/*/package.json',
'npm:devextreme-angular@22.2.6/package.json',
'npm:devexpress-diagram@2.1.72/package.json',
'npm:devexpress-gantt@4.1.43/package.json',
],
};
System.config(window.config);
<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml">
<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/22.2.6/css/dx.light.css" />
<link rel="stylesheet" type="text/css" href="https://cdn3.devexpress.com/jslib/22.2.6/css/dx-gantt.css" />
<script src="https://unpkg.com/core-js@2.6.12/client/shim.min.js"></script>
<script src="https://unpkg.com/zone.js@0.13.0/dist/zone.js"></script>
<script src="https://unpkg.com/reflect-metadata@0.1.13/Reflect.js"></script>
<script src="https://unpkg.com/systemjs@0.21.3/dist/system.js"></script>
<script src="config.js"></script>
<script>
System.import("app").catch(console.error.bind(console));
</script>
</head>
<body class="dx-viewport">
<div class="demo-container">
<demo-app>Loading...</demo-app>
</div>
</body>
</html>