Treeview Data Binding to Flat Data
This article explains how to bind the TreeView for Blazor to flat data. Before continuing, make sure you are familiar with the treeview data binding basics.
Flat data means that the entire collection of treeview items is available at one level, for example List<MyTreeItemModel>
.
The parent-child relationships are created through internal data in the model - the Parent
field which points to the Id
of the item that will contain the current item. The root level has null
for Parent
. There must be at least one node with a null
value so that the TreeView renders anything.
You must also provide the correct value for the HasChildren
field - for items that have children, you must set it to true
so that the expand arrow is rendered.
Using self-referencing flat data
<TelerikTreeView Data="@FlatData" @bind-ExpandedItems="@ExpandedItems">
<TreeViewBindings>
<TreeViewBinding ParentIdField="Parent" />
</TreeViewBindings>
</TelerikTreeView>
@code {
public IEnumerable<TreeItem> FlatData { get; set; }
public IEnumerable<object> ExpandedItems { get; set; } = new List<TreeItem>();
public class TreeItem //most fields use the default names and will bind automatically in this example
{
public int Id { get; set; }
public string Text { get; set; }
public int? Parent { get; set; } //this is a non-default field name
public bool HasChildren { get; set; }
}
protected override void OnInitialized()
{
FlatData = LoadFlat();
ExpandedItems = FlatData.Where(x => x.HasChildren == true).ToList();
}
private List<TreeItem> LoadFlat()
{
List<TreeItem> items = new List<TreeItem>();
items.Add(new TreeItem()
{
Id = 1,
Text = "Parent 1",
Parent = null, // indicates a root (zero-level) item
HasChildren = true // informs the treeview there are children so it renders the expand option
});
items.Add(new TreeItem()
{
Id = 2,
Text = "Parent 2",
Parent = null, // indicates a root item
HasChildren = true
});
items.Add(new TreeItem()
{
Id = 3,
Text = "Parent 3",
Parent = null, // indicates a root item
HasChildren = false //there will be no children in this item
});
items.Add(new TreeItem()
{
Id = 4,
Text = "Child 1 of Parent 1",
Parent = 1, // the parent will be the first item
HasChildren = false
});
items.Add(new TreeItem()
{
Id = 5,
Text = "Child 2 of Parent 1",
Parent = 1, // the parent will be the first item
HasChildren = true
});
items.Add(new TreeItem()
{
Id = 6,
Text = "Child 1 of Child 2",
Parent = 5, // the parent will be the first child of the first root item
HasChildren = false
});
items.Add(new TreeItem()
{
Id = 7,
Text = "Child 1 of Parent 2",
Parent = 2, // the parent will be the second root item
HasChildren = false
});
return items;
}
}