All docs
V19.2
24.2
The page you are viewing does not exist in version 24.2.
24.1
The page you are viewing does not exist in version 24.1.
23.2
The page you are viewing does not exist in version 23.2.
23.1
The page you are viewing does not exist in version 23.1.
22.2
The page you are viewing does not exist in version 22.2.
22.1
The page you are viewing does not exist in version 22.1.
21.2
The page you are viewing does not exist in version 21.2.
21.1
The page you are viewing does not exist in version 21.1.
20.2
The page you are viewing does not exist in version 20.2.
20.1
The page you are viewing does not exist in version 20.1.
19.2
19.1
The page you are viewing does not exist in version 19.1.
18.2
The page you are viewing does not exist in version 18.2.
18.1
The page you are viewing does not exist in version 18.1.
17.2
The page you are viewing does not exist in version 17.2.
Box
Map
Vue
A newer version of this page is available. Switch to the current version.

JavaScript/jQuery TreeView - items

An array of items displayed by the widget.

Raised Events: onOptionChanged

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 property 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 property specified in React. Accepts a rendering function. Refer to Using a Rendering Function for more information.

selected

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

Type:

Boolean

Default Value: false

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

See Also

template

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

Type:

template

Template Data: undefined

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