Class
TelerikTreeList<TItem>

A hierarchical data grid for displaying, editing, and interacting with tree-structured data. Bind fields for hierarchy with IdField, ParentIdField, ItemsField, and HasChildrenField; define columns in TreeListColumns. Supports expand/collapse events (OnExpand/OnCollapse), row events (OnRowRender/OnRowClick/OnRowDoubleClick/OnRowContextMenu), state persistence via OnStateInit/OnStateChanged with get/set APIs (GetState()/SetStateAsync(TreeListState<TItem>)). Provides selection modes (SelectionMode), cell selection and range with SelectedCells/SelectedCellsChanged; editing modes (EditMode Inline/Popup/Incell), filtering (FilterMode), scrolling (ScrollMode Scrollable/Virtual), toolbar templates (TreeListToolBar or TreeListToolBarTemplate), and pager customization (TreeListPagerTemplate). Drag-and-drop rows via OnRowDrop; programmatic utilities include auto-fit methods (AutoFitColumn(string), AutoFitColumns(IEnumerable<string>), AutoFitAllColumns()). Children: TreeListColumns, TreeListToolBarTemplate, TreeListToolBar.

Definition

Namespace:Telerik.Blazor.Components

Assembly:Telerik.Blazor.dll

Type Parameters:

TItem

The type of the model to which the TreeList is bound.

Syntax:

cs-api-definition
public class TelerikTreeList<TItem> : TableGridBase<TItem, TreeListCommandEventArgs>, IComponent, IHandleEvent, IHandleAfterRender, IDisposable

Inheritance: objectComponentBaseBaseComponentDataBoundComponent<TItem>GridBase<TItem>TableGridBase<TItem, TreeListCommandEventArgs>TelerikTreeList<TItem>

Implements: IComponentIDisposableIHandleAfterRenderIHandleEvent

Inherited Members TableGridBase<TItem, TreeListCommandEventArgs>._selectedItemsMapTableGridBase<TItem, TreeListCommandEventArgs>.OnAfterRender(bool)TableGridBase<TItem, TreeListCommandEventArgs>.Dispose()TableGridBase<TItem, TreeListCommandEventArgs>.SetMultiColumnHeaders()TableGridBase<TItem, TreeListCommandEventArgs>.OnParametersSet()TableGridBase<TItem, TreeListCommandEventArgs>.HandleVirtualScrollPaging()TableGridBase<TItem, TreeListCommandEventArgs>.SetSkip(int)TableGridBase<TItem, TreeListCommandEventArgs>.ResetEditContext()TableGridBase<TItem, TreeListCommandEventArgs>.PageData()TableGridBase<TItem, TreeListCommandEventArgs>.GetItemFromDropIndex(string)TableGridBase<TItem, TreeListCommandEventArgs>.GetItemFromDropIndex(int)TableGridBase<TItem, TreeListCommandEventArgs>.DialogFactoryTableGridBase<TItem, TreeListCommandEventArgs>.IdTableGridBase<TItem, TreeListCommandEventArgs>.ColumnVirtualizationTableGridBase<TItem, TreeListCommandEventArgs>.AutoGenerateColumnsTableGridBase<TItem, TreeListCommandEventArgs>.NavigableTableGridBase<TItem, TreeListCommandEventArgs>.RowTemplateTableGridBase<TItem, TreeListCommandEventArgs>.NoDataTemplateTableGridBase<TItem, TreeListCommandEventArgs>.ResizableTableGridBase<TItem, TreeListCommandEventArgs>.ReorderableTableGridBase<TItem, TreeListCommandEventArgs>.SortableTableGridBase<TItem, TreeListCommandEventArgs>.SortModeTableGridBase<TItem, TreeListCommandEventArgs>.FilterMenuTypeTableGridBase<TItem, TreeListCommandEventArgs>.SelectedItemsTableGridBase<TItem, TreeListCommandEventArgs>.SelectedItemsChangedTableGridBase<TItem, TreeListCommandEventArgs>.EnableLoaderContainerTableGridBase<TItem, TreeListCommandEventArgs>.RowDraggableTableGridBase<TItem, TreeListCommandEventArgs>.ConfirmDeleteTableGridBase<TItem, TreeListCommandEventArgs>.RowHeightTableGridBase<TItem, TreeListCommandEventArgs>.FilterRowDebounceDelayTableGridBase<TItem, TreeListCommandEventArgs>.ShowColumnMenuTableGridBase<TItem, TreeListCommandEventArgs>.OnCreateTableGridBase<TItem, TreeListCommandEventArgs>.OnUpdateTableGridBase<TItem, TreeListCommandEventArgs>.OnDeleteTableGridBase<TItem, TreeListCommandEventArgs>.OnEditTableGridBase<TItem, TreeListCommandEventArgs>.OnAddTableGridBase<TItem, TreeListCommandEventArgs>.OnCancelTableGridBase<TItem, TreeListCommandEventArgs>.IsPopupRenderingTableGridBase<TItem, TreeListCommandEventArgs>.CurrentBreakpointGridBase<TItem>.WidthGridBase<TItem>.HeightGridBase<TItem>.PageSizeChangedGridBase<TItem>.PageSizeGridBase<TItem>.PageGridBase<TItem>.PageChangedGridBase<TItem>.PageableGridBase<TItem>.OnModelInitGridBase<TItem>.TotalCountDataBoundComponent<TItem>.Rebind()DataBoundComponent<TItem>.DataBaseComponent.ShouldRender()BaseComponent.OnInitializedAsync()BaseComponent.InitLocalizer()BaseComponent.ThrowIfParameterIsNull(object, string)BaseComponent.HaveOptionsChanged(IDictionary<string, object>, IDictionary<string, object>)BaseComponent.GetClassString(params string[])BaseComponent.InvokeAsync<T>(string, params object[])BaseComponent.InvokeAsync<T>(string, CancellationToken, params object[])BaseComponent.InvokeVoidAsync(string, params object[])BaseComponent.InvokeVoidAsyncWithoutAwait(string, params object[])BaseComponent.InvokeComponentMethodAsync<T>(string, params object[])BaseComponent.InvokeComponentMethodAsync<T>(string, CancellationToken, params object[])BaseComponent.InvokeVoidComponentMethodAsync(string, params object[])BaseComponent.InvokeComponentVoidMethodAsync(string, object)BaseComponent.InvokeDisposeAsync()BaseComponent.StateHasChanged()BaseComponent.RootComponentBaseComponent.ClassComponentBase.OnInitialized()ComponentBase.OnParametersSet()ComponentBase.OnAfterRender(bool)ComponentBase.InvokeAsync(Action)ComponentBase.InvokeAsync(Func<Task>)ComponentBase.DispatchExceptionAsync(Exception)

Properties

EditFieldOnStateInit

Declaration

cs-api-definition
protected string EditFieldOnStateInit { get; set; }

Property Value

string

EditMode

Defines the EditMode of the TreeList. Supports None, Inline, Popup and Incell editing. The Default Option is None.

Declaration

cs-api-definition
[Parameter]
public TreeListEditMode EditMode { get; set; }

Property Value

TreeListEditMode

EnableWebMcpTools

Enables WebMCP tool registration for this TreeList. When true, TreeList operations are exposed as tools discoverable by AI models through the browser. Configure tool names and overrides via TreeListWebMcpSettings inside TreeListSettings.

Declaration

cs-api-definition
[Parameter]
public bool EnableWebMcpTools { get; set; }

Property Value

bool

FilterMode

Defines the Filter Mode of the Component.

Declaration

cs-api-definition
[Parameter]
public TreeListFilterMode FilterMode { get; set; }

Property Value

TreeListFilterMode

HasChildrenField

Defines the HasChildren DataField of the DataSource.

Declaration

cs-api-definition
[Parameter]
public string HasChildrenField { get; set; }

Property Value

string

IdField

Defines the Id DataField of the DataSource.

Declaration

cs-api-definition
[Parameter]
public string IdField { get; set; }

Property Value

string

ItemsField

Defines the Items DataField of the DataSource that contains the child nodes.

Declaration

cs-api-definition
[Parameter]
public string ItemsField { get; set; }

Property Value

string

NewRowPosition

The position at which a new data item is inserted in the TreeList - top or bottom. Default value is Top.

Declaration

cs-api-definition
[Parameter]
public TreeListNewRowPosition NewRowPosition { get; set; }

Property Value

TreeListNewRowPosition

OnCollapse

Fires when a row is collapsed.

Declaration

cs-api-definition
[Parameter]
public EventCallback<TreeListCollapseEventArgs> OnCollapse { get; set; }

Property Value

EventCallback<TreeListCollapseEventArgs>

OnExpand

Fires when a row is expanded.

Declaration

cs-api-definition
[Parameter]
public EventCallback<TreeListExpandEventArgs> OnExpand { get; set; }

Property Value

EventCallback<TreeListExpandEventArgs>

OnRowClick

Fires when the user clicks on a row, or presses enter.

Declaration

cs-api-definition
[Parameter]
public EventCallback<TreeListRowClickEventArgs> OnRowClick { get; set; }

Property Value

EventCallback<TreeListRowClickEventArgs>

OnRowContextMenu

Fires when the user triggers contextmenu event with click or context menu button.

Declaration

cs-api-definition
[Parameter]
public EventCallback<TreeListRowClickEventArgs> OnRowContextMenu { get; set; }

Property Value

EventCallback<TreeListRowClickEventArgs>

OnRowDoubleClick

Fires when the user double-clicks on a row.

Declaration

cs-api-definition
[Parameter]
public EventCallback<TreeListRowClickEventArgs> OnRowDoubleClick { get; set; }

Property Value

EventCallback<TreeListRowClickEventArgs>

OnRowDrop

Fired when a row is dropped.

Declaration

cs-api-definition
[Parameter]
public EventCallback<TreeListRowDropEventArgs<TItem>> OnRowDrop { get; set; }

Property Value

EventCallback<TreeListRowDropEventArgs<TItem>>

OnRowRender

Called each time a row is rendered. Use this to add custom classes to the row based on the data item.

Declaration

cs-api-definition
[Parameter]
public Action<TreeListRowRenderEventArgs> OnRowRender { get; set; }

Property Value

Action<TreeListRowRenderEventArgs>

OnStateChanged

Fires on user interaction that causes changes in the TreeListState<TItem>.

Declaration

cs-api-definition
[Parameter]
public EventCallback<TreeListStateEventArgs<TItem>> OnStateChanged { get; set; }

Property Value

EventCallback<TreeListStateEventArgs<TItem>>

OnStateInit

Invoked when the TreeList is initialized and state could be loaded. Useful when you'd like to persist changed on page reloads.

Declaration

cs-api-definition
[Parameter]
public EventCallback<TreeListStateEventArgs<TItem>> OnStateInit { get; set; }

Property Value

EventCallback<TreeListStateEventArgs<TItem>>

ParentIdField

Defines the ParentId DataField of the DataSource. Use this DataField when the component is bound to a flat data structure.

Declaration

cs-api-definition
[Parameter]
public string ParentIdField { get; set; }

Property Value

string

ScrollMode

Defines scrolling mode of the TreeList. Possible values are Scrollable and Virtual.

Declaration

cs-api-definition
[Parameter]
public TreeListScrollMode ScrollMode { get; set; }

Property Value

TreeListScrollMode

SelectedCells

Defines the collection of selected cells. The parameter supports two-way binding. Also set SelectionMode.

Declaration

cs-api-definition
[Parameter]
public IEnumerable<TreeListSelectedCellDescriptor> SelectedCells { get; set; }

Property Value

IEnumerable<TreeListSelectedCellDescriptor>

SelectedCellsChanged

The event fires when users select or unselect cell.

Declaration

cs-api-definition
[Parameter]
public EventCallback<IEnumerable<TreeListSelectedCellDescriptor>> SelectedCellsChanged { get; set; }

Property Value

EventCallback<IEnumerable<TreeListSelectedCellDescriptor>>

SelectionMode

Defines the Selection Mode of the TreeList.

Declaration

cs-api-definition
[Parameter]
public TreeListSelectionMode SelectionMode { get; set; }

Property Value

TreeListSelectionMode

TreeListColumns

Defines the container for the TreeList columns. Children: TreeListColumn, TreeListCheckboxColumn, TreeListCommandColumn.

Declaration

cs-api-definition
[Parameter]
public RenderFragment TreeListColumns { get; set; }

Property Value

RenderFragment

TreeListPagerTemplate

Defines the template that will be displayed instead of the Pager.

Declaration

cs-api-definition
[Parameter]
public RenderFragment TreeListPagerTemplate { get; set; }

Property Value

RenderFragment

TreeListSettings

Declaration

cs-api-definition
[Parameter]
public RenderFragment TreeListSettings { get; set; }

Property Value

RenderFragment

TreeListToolBar

Declaration

cs-api-definition
[Parameter]
public RenderFragment TreeListToolBar { get; set; }

Property Value

RenderFragment

TreeListToolBarTemplate

Defines the toolbar of the TreeList.

Declaration

cs-api-definition
[Parameter]
public RenderFragment TreeListToolBarTemplate { get; set; }

Property Value

RenderFragment

Methods

AutoFitAllColumns()

Declaration

cs-api-definition
public void AutoFitAllColumns()

AutoFitAllColumnsAsync()

Declaration

cs-api-definition
public Task AutoFitAllColumnsAsync()

Returns

Task

AutoFitColumn(string)

Declaration

cs-api-definition
public void AutoFitColumn(string id)

Parameters

id

string

AutoFitColumnAsync(string)

Declaration

cs-api-definition
public Task AutoFitColumnAsync(string id)

Parameters

id

string

Returns

Task

AutoFitColumns(IEnumerable<string>)

Declaration

cs-api-definition
public void AutoFitColumns(IEnumerable<string> ids)

Parameters

ids

IEnumerable<string>

AutoFitColumnsAsync(IEnumerable<string>)

Declaration

cs-api-definition
public Task AutoFitColumnsAsync(IEnumerable<string> ids)

Parameters

ids

IEnumerable<string>

Returns

Task

BuildRenderTree(RenderTreeBuilder)

Declaration

cs-api-definition
protected override void BuildRenderTree(RenderTreeBuilder __builder)

Parameters

__builder

RenderTreeBuilder

Overrides ComponentBase.BuildRenderTree(RenderTreeBuilder)

Dispose()

Declaration

cs-api-definition
public override void Dispose()

Overrides TableGridBase<TItem, TreeListCommandEventArgs>.Dispose()

GetItemFromDropIndex(int)

Declaration

cs-api-definition
protected override TItem GetItemFromDropIndex(int index)

Parameters

index

int

Returns

TItem

Overrides TableGridBase<TItem, TreeListCommandEventArgs>.GetItemFromDropIndex(int)

GetState()

Gets the current state of the TreeList. Includes sorting, filtering, edit items, column state, etc.

Declaration

cs-api-definition
public TreeListState<TItem> GetState()

Returns

TreeListState<TItem>

Instance of a TreeListState<TItem> class that contains all data.

OnAfterRenderAsync(bool)

Declaration

cs-api-definition
protected override Task OnAfterRenderAsync(bool firstRender)

Parameters

firstRender

bool

Returns

Task

Overrides BaseComponent.OnAfterRenderAsync(bool)

OnParametersSetAsync()

Declaration

cs-api-definition
protected override Task OnParametersSetAsync()

Returns

Task

Overrides DataBoundComponent<TItem>.OnParametersSetAsync()

SetParametersAsync(ParameterView)

Declaration

cs-api-definition
public override Task SetParametersAsync(ParameterView parameters)

Parameters

parameters

ParameterView

Returns

Task

Overrides DataBoundComponent<TItem>.SetParametersAsync(ParameterView)

SetSkip(int)

Declaration

cs-api-definition
protected override void SetSkip(int skip)

Parameters

skip

int

Overrides TableGridBase<TItem, TreeListCommandEventArgs>.SetSkip(int)

SetStateAsync(TreeListState<TItem>)

Sets the state of the TreeList. Includes sorting, filtering, edit items, column state, etc.

Declaration

cs-api-definition
public Task SetStateAsync(TreeListState<TItem> state)

Parameters

state

TreeListState<TItem>

Returns

Task