Components
- Barcodes
- Buttonsupdated
- Charts
- Conversational UIupdated
- Data Query
- Date Inputsupdated
- Date Math
- Dialogsupdated
- Drawing
- Dropdowns
- - Overview
  - Getting Started
  - AutoComplete
  - ComboBox
  - DropDownList
  - DropDownTree
  - MultiColumnComboBox
  - MultiSelect
  - MultiSelectTree
  - Appearance
  - Globalization
  - API
- Editorupdated
- Excel Export
- File Saver
- Filter
- Ganttupdated
- Gauges
- Gridupdated
- Iconsupdated
- Indicators
- Inputsupdated
- Labels
- Layoutupdated
- ListBoxupdated
- ListView
- Mapbeta
- Menusupdated
- Navigationupdated
- Notification
- Pagerupdated
- PDF Export
- PivotGridupdated
- Popup
- ProgressBars
- Ripple
- Schedulerupdated
- ScrollViewupdated
- Sortableupdated
- ToolBarupdated
- Tooltipsupdated
- TreeList
- TreeView
- Typography
- Uploadsupdated
- Utilities
Styling & Themes
Common Features
Project Setup
Knowledge Base
Sample Applications
FAQ
Troubleshooting
Updates
Changelogs

Components / Dropdowns / API / DropDownTreeComponent /

New to Kendo UI for Angular? Start a free 30-day trial

DropDownTreeComponent

Represents the Kendo UI DropDownTree component for Angular.

Export Name

Accessible in templates as #kendoDropDownTreeInstance="kendoDropDownTree"

Inputs

Name	Type	Default	Description
clearButton	`boolean`		If set to `true`, renders a button on hovering over the component. Clicking this button resets the value of the component to `undefined` and triggers the `change` event.
data	`Object[]`		Sets the data of the DropDownTree. The data has to be provided in an array-like list with objects.
dataItem	`Object`		Keeps the current `dataItem` object in order to resolve selection. Needs to be provided when `value` is bound in and `valuePrimitive` is set to true.
disabled	`boolean`		Sets the disabled state of the component.
fetchChildren	`(node: object) => Observable<object[]>`		A function which provides the child nodes for a given parent node.
fillMode	`DropDownFillMode`		Sets the fillMode of the component. The possible values are: `flat` `solid` (default) `outline` `none`
filterable	`boolean`		Renders the built-in input element for filtering the DropDownTree. If set to `true`, the component emits the `filterChange` event, which can be used to filter the DropDownTree manually. A built-in filtering implementation is available to use with the `kendoDropDownTreeHierarchyBinding` and `kendoDropDownTreeFlatBinding` directives.
hasChildren	`(node: object) => boolean`		A function which determines if a specific node has child nodes.
isNodeExpanded	`(item: object, index: string) => boolean`		A function that is executed for each data item and determines if a specific node is expanded.
isNodeVisible	`(item: object, index: string) => boolean`		A callback which determines whether a tree node should be rendered as hidden. The utility .k-hidden class is used to hide the nodes. Useful for custom filtering implementations.
itemDisabled	`(item: object, index: string) => boolean`		A function that is executed for each data item and determines if a specific item is disabled.
listHeight	`number`		Sets the height of the options list. By default, `listHeight` is 200px. The `listHeight` property affects only the list of options and not the whole popup container. To set the height of the popup container, use `popupSettings.height`.
loading	`boolean`		Sets and gets the loading state of the DropDownTree.
loadOnDemand	`boolean`	`true`	Indicates whether the child nodes will be fetched on node expand or will be initially prefetched.
placeholder	`string`		The hint which is displayed when the component is empty.
popupSettings	`PopupSettings`		Configures the popup of the DropDownTree. The available options are: `animate: Boolean`—Controls the popup animation. By default, the open and close animations are enabled. `width: Number \| String`—Sets the width of the popup container. By default, the width of the host element is used. If set to `auto`, the component automatically adjusts the width of the popup and no item labels are wrapped. `height: Number`—Sets the height of the popup container. `popupClass: String`—Specifies a list of CSS classes that are used to style the popup. `appendTo: "root" \| "component" \| ViewContainerRef`—Specifies the component to which the popup will be appended.
readonly	`boolean`		Sets the read-only state of the component.
rounded	`DropDownRounded`		Sets the border radius of the component. The possible values are: `small` `medium` (default) `large` `full` `none`
size	`DropDownSize`		Sets the size of the component. The possible values are: `small` `medium` (default) `large` `none`
tabindex	`number`		Specifies the `tabindex` of the component.
textField	`string \| string[]`		The fields of the data item that provide the text content of the nodes inside the DropDownTree (see example). If the `textField` input is set to an array, each hierarchical level uses the field that corresponds to the same index in the array, or the last item in the array. The `textField` property can be set to point to a nested property value - e.g. `category.name`.
value	`any`		Sets the value of the DropDownTree. It can either be of the primitive (string, numbers) or of the complex (objects) type. To define the type, use the `valuePrimitive` option.
valueDepth	`number`		Sets the level in the data set where the value can be found when `valueField` is an Array. The field serves to correctly allocate a data item used when the DropDownTree is initialized with a value.
valueField	`string \| string[]`		The fields of the data item that provide the value of the nodes inside the DropDownTree (see example). If the `valueField` input is set to an array, each hierarchical level uses the field that corresponds to the same index in the array, or the last item in the array. The `valueField` property can be set to point to a nested property value - e.g. `category.id`.
valuePrimitive	`boolean`		Specifies the type of the selected value (more information and example). If set to `true`, the selected value has to be of a primitive value.

Fields

Name	Type	Default	Description
isOpen	`boolean`		Returns the current open state of the popup.

Events

Name	Type	Description
close	`EventEmitter<PreventableEvent>`	Fires each time the popup is about to close (see example). This event is preventable. If you cancel it, the popup will remain open.
closed	`EventEmitter<any>`	Fires after the popup has been closed.
filterChange	`EventEmitter<string>`	Fires when the value of the built-in filter input element changes.
nodeCollapse	`EventEmitter<TreeItem>`	Fires when the user collapses a node in the popup TreeView.
nodeExpand	`EventEmitter<TreeItem>`	Fires when the user expands a node in the popup TreeView.
blur	`EventEmitter<any>`	Fires each time the DropDownTree gets blurred.
focus	`EventEmitter<any>`	Fires each time the user focuses the DropDownTree.
open	`EventEmitter<PreventableEvent>`	Fires each time the popup is about to open (see example). This event is preventable. If you cancel it, the popup will remain closed.
opened	`EventEmitter<any>`	Fires after the popup has been opened.
valueChange	`EventEmitter<any>`	Fires each time the value is changed (see example).

Methods

blur
Blurs the DropDownTree.

focus
Focuses the DropDownTree.

Focuses a specific item of the DropDownTree based on a provided index in the format of 1_1. The targeted item should be expanded in order for it to be focused. If null or invalid index is provided the focus will be set on the first item.

Parameters
index	`string`

reset
Resets the value of the DropDownTree. If you use the `reset` method to clear the value of the component, the model will not update automatically and the `valueChange` event will not be fired.

toggle

Toggles the visibility of the popup (see example). If you use the toggle method to open or close the popup, the open and close events will not be fired.

Parameters
open?	`boolean`	The state of the popup.

Product Bundles

DevCraft

Web

Mobile

Document Management

Desktop

Reporting & Mocking

Automated Testing

CMS

UI/UX Tools

Debugging

Extended Reality

Free Tools

DropDownTreeComponent

In this article

Not finding the help you need?