Getting Started with the Kendo UI for Angular TreeView
This guide provides the information you need to start using the Kendo UI for Angular TreeView —it includes instructions about the recommended installation approach, the code for running the project, and links to additional resources.
As of version
17.0.0
, Angular makes standalone component enabled by default. If you useNgModules
, refer to these articles:
The standalone components in Angular streamline development by removing the need for NgModules
, reducing complexity, and enhancing component reuse and modularity. This approach simplifies dependency management, making applications more maintainable and scalable.
After the completion of this guide, you will be able to achieve an end result as demonstrated in the following example.
Setting Up Your Angular Project
Before you start with the installation of any Kendo UI for Angular control, ensure that you have a running Angular project. The prerequisites to accomplish the installation of the components are always the same regardless of the Kendo UI for Angular package you want to use, and are fully described in the section on setting up your Angular project.
Installing the Component
The following command demonstrates an efficient, automated method for adding packages using the Angular CLI through the ng-add
command. This approach saves time and effort by executing a series of commands in a single step, which otherwise need to be run individually. Refer to the Manual Setup for more details.
To add the Kendo UI for Angular TreeView package:
-
Run the following command:
shng add @progress/kendo-angular-treeview
As a result, the
ng-add
command will perform the following actions:- Add the
@progress/kendo-angular-treeview
package as a dependency to thepackage.json
file. - Add all required peer dependencies to the
package.json
file. - Register the Kendo UI Default theme in the
angular.json
file. - Trigger
npm install
to install the theme and all peer packages that are added.
- Add the
-
Import the
KENDO_TREEVIEW
utility array in your standalone component to enable the entire feature set of the TreeView:The utility array is available starting from
v16.6.0
. If you use an older version of the package, please follow the approach from the Using Kendo Angular Components with NgModules article.tsimport { Component } from '@angular/core'; import { KENDO_TREEVIEW } from '@progress/kendo-angular-treeview'; @Component({ standalone: true, selector: 'my-app', imports: [KENDO_TREEVIEW] })
Using the Component
-
After successfully installing the TreeView package and importing its component, add the following code in the
app.component.html
file:html<kendo-treeview [nodes]="data" kendoTreeViewHierarchyBinding textField="text" childrenField="items" > </kendo-treeview>
-
Create the data source in your
app.component.ts
file:tsexport class AppComponent { public data: any[] = [ { text: 'Furniture', items: [ { text: 'Tables & Chairs' }, { text: 'Sofas' }, { text: 'Occasional Furniture' } ] }, ]; }
-
Build and serve the application by running the following command in the root folder.
shng serve
-
Point your browser to http://localhost:4200 to see the Kendo UI for Angular TreeView component on the page.
Activating Your License Key
As of December 2020, using any of the UI components from the Kendo UI for Angular library requires either a commercial license key or an active trial license key. If your application does not contain a Kendo UI license file, activate your license key.
Next Steps
- TreeView Dependencies & Standalone Utilities
- TreeView Data Binding
- Filtering the TreeView
- Events of the TreeView
- Adding Checkboxes
- TreeView Drag-and-Drop Functionality
- TreeView Persist the Expanded State
- Keyboard Navigation in the TreeView
- Globalization of the TreeView
- API Reference of the TreeView