items[]

An array of items displayed by the widget.

Raised Events: optionChanged

The TreeView works with object collections that can have a plain or hierarchical structure. Depending on the structure, the objects should provide different data fields. Specify the dataStructure option to notify the TreeView of the used structure and refer to the option's description for information on the required fields.

If you need to update the widget items, reassign the entire items array as shown in the following example:

JavaScript
treeViewInstance.option('items', newItems);

As an alternative to items, you can use the dataSource option. It accepts the DataSource object, whose underlying stores provide an API that allows you to update individual items without reassigning the entire item collection.

NOTE
Do not use the items option if you use dataSource, and vice versa.

component

An alias for the template option specified in React. Accepts a custom component. Refer to Using a Custom Component for more information.

disabled

Specifies whether the widget item responds to user interaction.

Type:

Boolean

Default Value: false

expanded

Specifies whether or not the tree view item is displayed expanded.

Type:

Boolean

Default Value: false

This field makes sense no matter whether a custom template or the default one is used.

See Also

hasItems

Specifies whether or not the tree view item has children.

Type:

Boolean

Default Value: undefined

This field is used when the virtual mode is enabled. It can hold a Boolean value or a function that returns a Boolean value.

html

Specifies html code inserted into the widget item element.

Type:

String

icon

Specifies the tree view item's icon.

Type:

String

This option accepts one of the following:

items

Specifies nested tree view items.

Nested items should have the same structure as the first-level items.

See Also

parentId

Holds the key of the parent item.

Type:

Number

|

String

Default Value: undefined

This field makes sense no matter whether a custom template or the default one is used.

render

An alias for the template option specified in React. Accepts a rendering function. Refer to Using a Rendering Function for more information.

selected

Specifies whether the TreeView item should be displayed as selected.

Type:

Boolean

Default Value: false

See Also

template

Specifies a template that should be used to render this item only.

Type:

template

Return Value:

String

|

DOM Node

|

jQuery

A template name or container.

The following types of the specified value are available.

  • Assign a string containing the name of the required template.
  • Assign a jQuery object of the template's container.
  • Assign a DOM Node of the template's container.
  • Assign a function that returns the jQuery object or a DOM Node of the template's container.
See Also

text

Specifies text displayed for the widget item.

Type:

String

visible

Specifies whether or not a widget item must be displayed.

Type:

Boolean

Default Value: true