Ajax Binding
You can configure the Telerik UI TreeList for Ajax binding to make Ajax requests upon loading child nodes, sorting, or filtering.
When configured for Ajax binding, the Telerik UI TreeList for ASP.NET Core makes Ajax requests when doing sorting, filtering or when expanding a node.
The Ajax-bound mode has the following features:
-
The TreeList retrieves only the data (in JSON format) representing the current level items.
To use lazy-loading define the
hasChildren
property of the Modelpublic class EmployeeViewModel { // The Id. public int EmployeeID { get; set; }
public string FirstName { get; set; } // This is a case-sensitive property. Define it only if you want to use lazy-loading. // If it is not defined, the TreeList will calculate and assign its value on the client. public bool hasChildren { get; set; }
}
- All column templates are executed client-side. They follow the Kendo UI for jQuery template definition rules and may contain embedded JavaScript code.
To configure the TreeList for ASP.NET Core to do Ajax binding:
- Create a new ASP.NET Core web application. Follow the steps from the introductory article to add Telerik UI for ASP.NET Core to the application.
-
Open the
HomeController.cs
and add a new action method which will return the items as JSON. The TreeList makes Ajax requests to this action.public ActionResult TreeList_Read() { }
-
Add a new parameter of type
Kendo.Mvc.UI.DataSourceRequest
to the action. It will contain the current TreeList request information about sorting, aggregates and filtering. Decorate that parameter with theKendo.Mvc.UI.DataSourceRequestAttribute
. This attribute will populate theDataSourceRequest
object from the posted data. Now import theKendo.Mvc.UI
namespace. Also add another parameter which will indicate which parent node has been expanded.public ActionResult TreeList_Read([DataSourceRequest]DataSourceRequest request, int? id) { }
-
Use the
ToTreeDataSourceResult
extension method to convert the items collection to aKendo.Mvc.UI.TreeDataSourceResult
object. This extension method will filter, sort, calculate aggregates and find only the current level items of your data using the information provided by theDataSourceRequest
object. To use theToTreeDataSourceResult
extension method, import theKendo.Mvc.Extensions
namespace.public JsonResult TreeList_Read([DataSourceRequest] DataSourceRequest request, int? id) { var result = ((EmployeeDirectoryService) employeeDirectory).GetAllRemote().ToTreeDataSourceResult(request, e => e.EmployeeId, e => e.ReportsTo, e => id.HasValue ? e.ReportsTo == parentId : e.ReportsTo == null, e => e ); }
-
Return the
TreeDataSourceResult
as JSON. Configure the Telerik UI TreeList for Ajax binding.public JsonResult TreeList_Read([DataSourceRequest] DataSourceRequest request, int? id) { var result = ((EmployeeDirectoryService) employeeDirectory).GetAllRemote().ToTreeDataSourceResult(request, e => e.EmployeeId, e => e.ReportsTo, e => id.HasValue ? e.ReportsTo == parentId : e.ReportsTo == null, e => e ); return Json(result); }
-
In the view, configure the TreeList to use the action method created in the previous steps.
@(Html.Kendo().TreeList<Kendo.Mvc.Examples.Models.TreeList.EmployeeDirectoryRemoteModel>() .Name("treelist") .Columns(columns => { columns.Add().Field(f => f.FirstName).Width(250).Title("First Name"); columns.Add().Field(e => e.LastName).Title("Last Name"); columns.Add().Field(e => e.Position); columns.Add().Field(e => e.Extension).Title("Ext").Format("{0:#}"); }) .Filterable() .Sortable() .DataSource(dataSource => dataSource .Read(read => read.Action("TreeList_Read", "Home")) .Model(m => { m.Id(f => f.EmployeeId); m.ParentId(f => f.ReportsTo).Nullable(true); m.Field(f => f.FirstName); m.Field(f => f.LastName); m.Field(f => f.ReportsTo); }) .Aggregates(x=> x.Add(y=> y.BirthDate).Count()) ) )
<kendo-treelist name="treelist"> <columns> <treelist-column field="FirstName" title="First Name" width="250px"></treelist-column> <treelist-column field="LastName" title="Last Name"></treelist-column> <treelist-column field="Position"></treelist-column> <treelist-column field="Extension" title="Ext" format="{0:#}"></treelist-column> </columns> <filterable enabled="true"/> <sortable enabled="true"/> <treelist-datasource> <transport> <read url="@Url.Action("TreeList_Read","Home")"/> </transport> <aggregates> <aggregate field="BirthDate" aggregate="count" /> </aggregates> <schema data="Data" total="Total" errors="Errors"> <treelist-model id="EmployeeId" parent-id="ReportsTo"> <fields> <field name="EmployeeId" type="number"></field> <field name="ReportsTo" nullable="true"></field> <field name="FirstName" type="string"></field> <field name="LastName" type="string"></field> <field name="Position" type="string"></field> <field name="Extension" type="number"></field> </fields> </treelist-model> </schema> </treelist-datasource> </kendo-treelist>
Build and run the application.