Editing by using the Click-Move-Click functionality
As of Telerik UI for ASP.NET Core UI R2 SP1 2023, users can reorder the TreeList's rows by using the click-move-click functionality provided by the Editable.Move.ClickMoveClick configuration option. To allow the user to use the functionality make sure to also add a column with a drag handle via the .Draggable() configuration method. To start moving the row, users can click the drag icon, and then click again to place the row in its new position.
Refer to the example below for the configuration details:
@(Html.Kendo().TreeList<EmployeeViewModel>()
.Name("treelist")
.Columns(columns =>
{
columns.Draggable().Width(70);
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);
})
.Editable(editable => editable.Move(move => move.Reorderable(true).ClickMoveClicl(true)))
.DataSource(dataSource => dataSource
.Read(read => read.Action("Employees_Read", "TreeList"))
.Update(update => update.Action("Employees_Update", "TreeList"))
.Model(m =>
{
m.Id(f => f.OrderID);
m.ParentId(f => f.ParentOrderID).Nullable(true);
m.Expanded(true);
})
)
/* other TreeList settings */
)
<kendo-treelist name="treelist">
<columns>
<treelist-column draggable="true"></treelist-column>
<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>
</columns>
<editable enabled="true">
<move reorderable="true" click-move-click="true"/>
</editable>
...
<treelist-datasource>
<transport>
<read url="@Url.Action("Employees_Read","TreeList")"/>
<update url="@Url.Action("Employees_Update","TreeList")"/>
</transport>
<schema data="Data" total="Total" errors="Errors">
<treelist-model id="OrderID" parent-id="ParentOrderID" expanded="true">
<fields>
<field name="OrderID" type="number"></field>
<field name="ParentOrderID" nullable="true" type="number"></field>
</fields>
</treelist-model>
</schema>
</treelist-datasource>
</kendo-treelist>
Editing by Dragging and Dropping
Currently, the dragging and dropping of items (
.Editable(editable=>editable.Move(true))and.Editable(editable=>editable.Move(move => move.Reorderable(true)))) is not supported with the incell edit mode of the TreeList because the draggable functionality prevents themousedownevent. As a result, thechangeevent of the editor input does not fire, which in turn prevents the MVVM binding from saving the updated value. To work around this problem, refer to this GitHub issue.
When the .Editable(editable=>editable.Move(true)) property is set to true, the user can drag and drop the rows and the TreeList internally updates the ParentId field. Setting the .Editable(editable=>editable.Move(move => move.Reorderable(true))) property to true enables users not only to move items to a different level in the hierarchy but also allows users to reorder items within a particular hierarchy level.
To persist the new hierarchy, configure the TreeList data source for CRUD operations and set transport.update as a bare minimum. For a runnable example, refer to the demo on editing by dragging and dropping the rows of the TreeList.
@(Html.Kendo().TreeList<EmployeeViewModel>()
.Name("treelist")
.Editable(editable => editable.Move(move => move.Reorderable(true))
.DataSource(dataSource => dataSource
.Read(read => read.Action("Employees_Read", "TreeList"))
.Update(update => update.Action("Employees_Update", "TreeList"))
.Model(m =>
{
m.Id(f => f.OrderID);
m.ParentId(f => f.ParentOrderID).Nullable(true);
m.Expanded(true);
})
)
/* other TreeList settings */
)
<kendo-treelist name="treelist">
<editable enabled="true">
<move reorderable="true"/>
</editable>
...
<treelist-datasource>
<transport>
<read url="@Url.Action("Employees_Read","TreeList")"/>
<update url="@Url.Action("Employees_Update","TreeList")"/>
</transport>
<schema data="Data" total="Total" errors="Errors">
<treelist-model id="OrderID" parent-id="ParentOrderID" expanded="true">
<fields>
<field name="OrderID" type="number"></field>
<field name="ParentOrderID" nullable="true" type="number"></field>
</fields>
</treelist-model>
</schema>
</treelist-datasource>
</kendo-treelist>
// The TreeList sends the updated items with prefix "models".
// Remember to bind it in the controller so that the collection can be intercepted.
public JsonResult Update([DataSourceRequest] DataSourceRequest request, [Bind(Prefix = "models")]IEnumerable<EmployeeDirectoryModel> employees).
{
if (ModelState.IsValid)
{
foreach (var employee in employees)
{
employeeDirectory.Update(employee, ModelState);
}
}
return Json(employees.ToTreeDataSourceResult(request, ModelState));
}