Components / TreeList / API / TreeListProps / 

TreeListProps

Represents the props of the KendoReact TreeList component.

NameTypeDefaultDescription

cellRender?

(defaultRendering: "null" | ReactElement<HTMLTableCellElement>, props: TreeListCellProps) => "null" | ReactElement<HTMLTableCellElement>

Fires when a cell is about to be rendered. Useful for overriding the default rendering of the cell.

className?

string

Sets custom CSS classes to the TreeList DOM element.

columnMenu?

React.ComponentType<any>

columnMenuFilter?

CompositeFilterDescriptor[]

columns?

TreeListColumnProps[]

A collection of TreeListColumnProps for creating columns.

columnVirtualization?

boolean

Enables the virtualization of the columns (see example). If enabled, the columns outside the viewport are not rendered.

data?

any[]

Sets the data of the TreeList.

dataItemKey?

string

Sets the TreeList row key prop to the value of this field in the dataItem. If not set, the dataItem index will be used for the row key, which might lead to row not updated during paging or scrolling.

editField?

string

Specifies the name of the field which will provide a Boolean representation of the edit state of the current item (more information and examples).

editRow?

React.ComponentType<TreeListRowProps>

If set and when the data item is in edit mode, the editRow value will be rendered.

expandField?

string

Specifies the name of the field which will provide a Boolean representation of the expanded state of the item.

filter?

FilterDescriptor[]

The descriptors by which the data is filtered (more information and examples). This affects the values and buttons in the FilterRow of the TreeList.

filterRow?

React.ComponentType<FilterRowProps>

If set, it will be rendered instead of the default FilterRow TreeList component.

headerCellRender?

(defaultRendering: ReactNode, props: TreeListHeaderCellProps) => ReactNode

Fires when a header cell is about to be rendered. Useful for overriding the default rendering of the header cell.

id?

string

Sets id to the TreeList DOM element.

navigatable?

boolean

If set to true, the user can use dedicated shortcuts to interact with the TreeList. By default, navigation is disabled and the TreeList content is accessible in the normal tab sequence.

noRecords?

React.ReactElement<TreeListNoRecordsProps>

Represents the component that will be rendered when the data property of the TreeList is empty or undefined.

onColumnMenuFilterChange?

(event: TreeListColumnMenuFilterChangeEvent) => void

onColumnReorder?

(event: TreeListColumnReorderEvent) => void

Fires when the columns are reordered.

onColumnResize?

(event: TreeListColumnResizeEvent) => void

Fires when a column is resized.

onDataStateChange?

(event: TreeListDataStateChangeEvent) => void

Fires when the data state of the TreeList is changed.

onExpandChange?

(event: TreeListExpandChangeEvent) => void

Fires when the user clicks on the expand or collapse icon of a row.

onFilterChange?

(event: TreeListFilterChangeEvent) => void

Fires when the TreeList filter is modified through the UI (more information and examples). You have to handle the event yourself and filter the data.

onHeaderSelectionChange?

(event: TreeListHeaderSelectionChangeEvent) => void

Fires when the user clicks the checkbox of a column header whose field matches selectedField (more information and example).

onItemChange?

(event: TreeListItemChangeEvent) => void

Fires when the user changes the values of the item. The event is not debounced and fires on every onChange event of the input in the current EditCell (more information and examples).

onKeyDown?

(event: TreeListKeyDownEvent) => void

Fires when the user press keyboard key.

onPageChange?

(event: TreeListPageChangeEvent) => void

Fires when the page of the TreeList is changed.

onRowClick?

(event: TreeListRowClickEvent) => void

Fires when the user clicks a row.

onRowContextMenu?

(event: TreeListRowContextMenuEvent) => void

Fires when the user trigger the context menu of row.

onRowDoubleClick?

(event: TreeListRowDoubleClickEvent) => void

Fires when the user double clicks a row.

onRowDrag?

(event: TreeListRowDragEvent) => void

Fires when a row is dragged.

onRowDrop?

(event: TreeListRowDragEvent) => void

Fires when a row is dragged and dropped.

onSelectionChange?

(event: TreeListSelectionChangeEvent) => void

Fires when the user tries to select or deselect a row or cell. (more information and example).

onSortChange?

(event: TreeListSortChangeEvent) => void

Fires when the sorting of the TreeList is changed (see example). You have to handle the event yourself and sort the data.

pager?

React.ComponentType<any>

The pager component that the TreeList will render.

reorderable?

boolean

If set to true, the user can reorder columns by dragging their header cells.

resizable?

boolean

If set to true, the user can resize columns by dragging the edges (resize handles) of their header cells.

row?

React.ComponentType<TreeListRowProps>

The TreeList row component.

rowDraggable?

boolean

If set to true, the user can drag and drop rows.

rowHeight?

number

Defines the row height and implements equal heights for all rows.

rowRender?

(row: ReactElement<HTMLTableRowElement>, props: TreeListRowProps) => ReactNode

Fires when a row is about to be rendered. Useful for overriding the default rendering of the row.

scrollable?

ScrollMode

Defines the scroll mode of the TreeList.

The available options are:

  • none—Renders no scrollbar.
  • scrollable—Represents the default scroll mode of the TreeList.

Requires you to set the overflow and height (for vertical scrolling), or width (for horizontal scrolling) styles.

  • virtual—Enables the vertical virtual scrolling of the TreeList.

Requires you to set the overflow and height styles and rowHeight prop of the TreeList.

selectable?

TreeListSelectableSettings

The TreeList selectable settings.

selectedField?

string

Specifies the name of the field which will provide a Boolean representation of the selected state of the item (see example).

skip?

number

The number of records that will be skipped.

sort?

SortDescriptor[]

The descriptors by which the data is sorted. Applies the sorting styles and buttons to the affected columns.

sortable?

SortSettings

Enables sorting (see example).

style?

React.CSSProperties

Represents the style HTML attribute.

subItemsField?

string

Specifies the name of the field which will provide an array representation of the item subitems.

tableProps?

React.DetailedHTMLProps<TableHTMLAttributes<HTMLTableElement>>

A props object that will be passed to the underlying HTML table.

take?

number

The number of records that will be taken.

toolbar?

React.ReactElement<TreeListToolbarProps>

Represents the TreeList toolbar component.

In this article

Not finding the help you need?

Contact Support