ASP.NET Core Gantt Overview
The Gantt is part of Telerik UI for ASP.NET Core, a
professional grade UI library with 110+ components for building modern and feature-rich applications. To try it out sign up for a free 30-day trial.
The Telerik UI Gantt TagHelper and HtmlHelper for ASP.NET Core are server-side wrappers for the Kendo UI Gantt widget.
The Gantt displays a set of tasks and dependencies which are used to visualize project-planning data. It provides a TreeList section where the user can edit the tasks, and sort and reorder them in a grid-like fashion, and a Timeline section where the tasks and dependencies are visualized under an adjustable time ruler. The user can resize, move, edit and remove them. The Gantt also supports the display of the Timeline section in the day, week, and month views.
As of the 2022 R3 release, the
Selectable
mechanism is altered. TheChange
event will now be fired only when Selection/Deselection is performed.
Initializing the Gantt
The following example demonstrates how to define the Gantt.
@(Html.Kendo().Gantt<TaskViewModel, DependencyViewModel>()
.Name("gantt")
.Columns(columns =>
{
columns.Bound(c => c.TaskID).Title("ID").Width(50);
columns.Bound(c => c.Title).Editable(true).Sortable(true);
columns.Bound(c => c.Start).Width(100).Editable(true).Sortable(true);
columns.Bound(c => c.End).Width(100).Editable(true).Sortable(true);
})
.Views(views =>
{
views.DayView();
views.WeekView(weekView => weekView.Selected(true));
views.MonthView();
})
.Height(700)
.ShowWorkHours(false)
.ShowWorkDays(false)
.Snap(false)
.DataSource(d => d
.Model(m =>
{
m.Id(f => f.TaskID);
m.ParentId(f => f.ParentID);
m.Field(f => f.Expanded).DefaultValue(true);
})
.Read("ReadTasks", "Gantt")
.Create("CreateTask", "Gantt")
.Destroy("DestroyTask", "Gantt")
.Update("UpdateTask", "Gantt")
)
.DependenciesDataSource(d => d
.Model(m =>
{
m.Id(f => f.DependencyID);
m.PredecessorId(f => f.PredecessorID);
m.SuccessorId(f => f.SuccessorID);
})
.Read("ReadDependencies", "Gantt")
.Create("CreateDependency", "Gantt")
.Destroy("DestroyDependency", "Gantt")
)
)
<kendo-gantt name="gantt" show-work-days="false" show-work-hours="false" snap="false" height="700">
<columns>
<gantt-column field="title" title="Title" editable="true" sortable="true"></gantt-column>
<gantt-column field="resources" title="Assigned Resources" editable="true" sortable="true"></gantt-column>
</columns>
<views>
<gantt-view type="GanttViewType.Day"></gantt-view>
<gantt-view type="GanttViewType.Week"></gantt-view>
<gantt-view type="GanttViewType.Month" selected="true"></gantt-view>
</views>
<gantt-datasource type="DataSourceTagHelperType.Ajax">
<transport>
<read url="@Url.Action("ReadTasks","Gantt")" />
</transport>
<schema>
<model id="TaskID">
<fields>
<field name="TaskID" type="number"></field>
<field name="parentId" from="ParentID" type="number"></field>
<field name="title" from="Title" type="string"></field>
<field name="start" from="Start" type="date"></field>
<field name="end" from="End" type="date"></field>
<field name="summary" from="Summary" type="boolean"></field>
<field name="expanded" from="Expanded" type="boolean" default-value="true"></field>
<field name="percentComplete" from="PercentComplete" type="number"></field>
<field name="orderId" from="OrderId" type="number"></field>
</fields>
</model>
</schema>
</gantt-datasource>
</kendo-gantt>
public partial class GanttController : Controller
{
private IGanttTaskService taskService;
private IGanttDependencyService dependencyService;
public GanttController(
IGanttTaskService ganttTaskService,
IGanttDependencyService ganttDependencyService)
{
taskService = ganttTaskService;
dependencyService = ganttDependencyService;
}
[Demo]
public ActionResult Index()
{
return View();
}
public virtual JsonResult ReadTasks([DataSourceRequest] DataSourceRequest request)
{
return Json(taskService.GetAll().ToDataSourceResult(request));
}
public virtual JsonResult DestroyTask([DataSourceRequest] DataSourceRequest request, TaskViewModel task)
{
if (ModelState.IsValid)
{
taskService.Delete(task, ModelState);
}
return Json(new[] { task }.ToDataSourceResult(request, ModelState));
}
public virtual JsonResult CreateTask([DataSourceRequest] DataSourceRequest request, TaskViewModel task)
{
if (ModelState.IsValid)
{
taskService.Insert(task, ModelState);
}
return Json(new[] { task }.ToDataSourceResult(request, ModelState));
}
public virtual JsonResult UpdateTask([DataSourceRequest] DataSourceRequest request, TaskViewModel task)
{
if (ModelState.IsValid)
{
taskService.Update(task, ModelState);
}
return Json(new[] { task }.ToDataSourceResult(request, ModelState));
}
public virtual JsonResult ReadDependencies([DataSourceRequest] DataSourceRequest request)
{
return Json(dependencyService.GetAll().ToDataSourceResult(request));
}
public virtual JsonResult DestroyDependency([DataSourceRequest] DataSourceRequest request, DependencyViewModel dependency)
{
if (ModelState.IsValid)
{
dependencyService.Delete(dependency);
}
return Json(new[] { dependency }.ToDataSourceResult(request, ModelState));
}
public virtual JsonResult CreateDependency([DataSourceRequest] DataSourceRequest request, DependencyViewModel dependency)
{
if (ModelState.IsValid)
{
dependencyService.Insert(dependency);
}
return Json(new[] { dependency }.ToDataSourceResult(request, ModelState));
}
}
Basic Configuration
The following example demonstrates the basic configuration of the Gantt.
@(Html.Kendo().Gantt<TaskViewModel, DependencyViewModel>()
.Name("gantt")
.Columns(columns =>
{
columns.Bound(c => c.Title).Editable(true).Sortable(true);
columns.Resources("resources").Editable(true).Title("Assigned Resources");
columns.Bound(c => c.Start).Width(100).Editable(true).Sortable(true);
columns.Bound(c => c.End).Width(100).Editable(true).Sortable(true);
})
.Views(views =>
{
views.DayView();
views.WeekView(weekView => weekView.Selected(true));
views.MonthView();
})
.Height(700)
.RowHeight(62)
.ShowWorkHours(false)
.ShowWorkDays(false)
.Snap(false)
.Pdf(pdf => pdf
.FileName("Kendo UI Gantt Export.pdf")
.ProxyURL(Url.Action("Pdf_Export_Save", "Gantt"))
)
.Resizable(true)
.DataSource(d => d
.Model(m =>
{
m.Id(f => f.TaskID);
m.ParentId(f => f.ParentID);
m.Field(f => f.Expanded).DefaultValue(true);
})
.Read("ReadTasks", "Gantt")
.Create("CreateTask", "Gantt")
.Destroy("DestroyTask", "Gantt")
.Update("UpdateTask", "Gantt")
)
.DependenciesDataSource(d => d
.Model(m =>
{
m.Id(f => f.DependencyID);
m.PredecessorId(f => f.PredecessorID);
m.SuccessorId(f => f.SuccessorID);
})
.Read("ReadDependencies", "Gantt")
.Create("CreateDependency", "Gantt")
.Destroy("DestroyDependency", "Gantt")
)
.Resources(r => r
.Field("resources")
.DataColorField("Color")
.DataTextField("Name")
.DataSource(d => d
.Custom()
.Schema(s => s
.Model(m => m.Id("ID"))
.Data("Data")
)
.Transport(t =>
{
t.Read("ReadResources", "Gantt");
})
)
)
.Assignments<ResourceAssignmentViewModel>(a => a
.DataTaskIdField("TaskID")
.DataResourceIdField("ResourceID")
.DataValueField("Units")
.DataSource(d => d
.Model(m =>
{
m.Id(f => f.ID);
})
.Read("ReadAssignments", "Gantt")
.Create("CreateAssignment", "Gantt")
.Destroy("DestroyAssignment", "Gantt")
.Update("UpdateAssignment", "Gantt")
)
)
)
<kendo-gantt name="gantt" show-work-days="false" show-work-hours="false" snap="false" height="700">
<tooltip visible="false" />
<current-time-marker enabled="false" />
<messages>
<views day="MyDay" week="MyWeek" month="MyMonth" />
</messages>
<columns>
<gantt-column field="title" title="Title" editable="true" sortable="true"></gantt-column>
<gantt-column field="resources" title="Assigned Resources" editable="true" sortable="true"></gantt-column>
</columns>
<views>
<gantt-view type="GanttViewType.Day"></gantt-view>
<gantt-view type="GanttViewType.Week"></gantt-view>
<gantt-view type="GanttViewType.Month" selected="true"></gantt-view>
</views>
</kendo-gantt>
Functionality and Features
Feature | Description |
---|---|
Layout | The layout of the Gantt consists of the GanttList and Timeline sections separated by a splitbar. |
Data binding | The Gantt provides various options for data binding. |
Columns | The Gantt columns offer configuration options for customizing the columns in the list section of the Gantt |
Planned vs Actual | You can compare the actual start and end dates with the originaly planned dates. |
PDF export | The Gantt has built-in PDF export capabilities. |
Select date range | You can configure the component to display tasks in a specified date range only. |
Resources | The Gantt allows you to assign optional resources to the Gantt tasks. |
Templates | You can customizing the rendering of the Gantt tasks through templates. |
Accessibility | The Gantt is accessible by screen readers and provides WAI-ARIA, Section 508, WCAG 2.2, and keyboard support. |