# ASP.NET Core DropDownTree Overview

The Telerik UI DropDownTree TagHelper and HtmlHelper for ASP.NET Core are server-side wrappers for the Kendo UI DropDownTree widget.

The DropDownTree represents an editor of hierarchical data, rendered in a tree-like structure, which provides multiple selection option and custom nodes.

* [Demo page for the DropDownTree HtmlHelper](https://demos.telerik.com/aspnet-core/dropdowntree/index)

* [Demo page for the DropDownTree TagHelper](https://demos.telerik.com/aspnet-core/dropdowntree/tag-helper)

## Initializing the DropDownTree

The following example demonstrates how to define the DropDownTree.

```Razor HtmlHelper
@(Html.Kendo().DropDownTree()
    .Name("dropdowntree")
    .DataTextField("Name")
    .DataValueField("id")
    .DataSource(dataSource => dataSource
        .Read(read => read
            .Action("Read_DropDownTreeData", "Home")
        )
    )
)
```

```Razor TagHelper
    <kendo-dropdowntree datatextfield="Name" datavaluefield="id" name="dropdowntree"  style="width: 100%">
        <hierarchical-datasource>
            <schema>
                <hierarchical-model id="id"></hierarchical-model>
            </schema>
            <transport>
                <read url="@Url.Action("Remote_DropDownTreeData", "Home")" />
            </transport>
        </hierarchical-datasource>
    </kendo-dropdowntree>
```

```C# Controller
public static IList<HierarchicalViewModel> GetHierarchicalData()
{
    var result = new List<HierarchicalViewModel>()
    {
        new HierarchicalViewModel() { ID = 1, ParentID = null, HasChildren = true, Name = "Parent item" },
        new HierarchicalViewModel() { ID = 2, ParentID = 1, HasChildren = true, Name = "Parent item" },
        new HierarchicalViewModel() { ID = 3, ParentID = 1, HasChildren = false, Name = "Item" },
        new HierarchicalViewModel() { ID = 4, ParentID = 2, HasChildren = false, Name = "Item" },
        new HierarchicalViewModel() { ID = 5, ParentID = 2, HasChildren = false, Name = "Item" }
    };

    return result;
}

public IActionResult Read_DropDownTreeData(int? id)
{
    var result = GetHierarchicalData()
        .Where(x => id.HasValue ? x.ParentID == id : x.ParentID == null)
        .Select(item => new {
            id = item.ID,
            Name = item.Name,
            hasChildren = item.HasChildren
        });

    return Json(result);
}
```

> Starting with the 2024 Q3 release, the HtmlHelper version of the component supports [declarative initialization](https://www.telerik.com/aspnet-core-ui/documentation/html-helpers/helper-basics/declarative-initialization).

## Basic Configuration

The following example demonstrates the basic configuration of the DropDownTree.

```Razor HtmlHelper
    @(Html.Kendo().DropDownTree()
        .Name("dropdowntree")
        .Items(dropdowntree =>
        {
            dropdowntree.Add().Text("My Web Site")
                .SpriteCssClasses("folder")
                .Expanded(true)
                .Items(root =>
                {
                    root.Add().Text("images")
                        .Expanded(true)
                        .SpriteCssClasses("folder")
                        .Items(images =>
                        {
                            images.Add().Text("logo.png")
                                .SpriteCssClasses("image");
                        });

                    root.Add().Text("resources")
                        .Expanded(true)
                        .SpriteCssClasses("folder")
                        .Items(resources =>
                        {
                            resources.Add().Text("pdf")
                                .Expanded(true)
                                .SpriteCssClasses("folder")
                                .Items(pdf =>
                                {
                                    pdf.Add().Text("prices.pdf")
                                        .SpriteCssClasses("pdf");
                                });

                            resources.Add().Text("zip")
                                .SpriteCssClasses("folder");
                        });

                    root.Add().Text("about.html")
                        .SpriteCssClasses("html");

                    root.Add().Text("index.html")
                        .SpriteCssClasses("html");
                });
        })
    )
```

```Razor TagHelper
    <kendo-dropdowntree name="dropdowntree">
        <items>
            <dropdowntree-item expanded="true" text="My Web Site" sprite-css-class="folder">
                <items>
                    <dropdowntree-item expanded="true" text="images" sprite-css-class="folder">
                        <items>
                            <dropdowntree-item text="logo.png" sprite-css-class="image">
                            </dropdowntree-item>
                        </items>
                    </dropdowntree-item>
                </items>
            </dropdowntree-item>
            <dropdowntree-item expanded="true" text="resources" sprite-css-class="folder">
                <items>
                    <dropdowntree-item expanded="true" text="pdf" sprite-css-class="folder">
                        <items>
                            <dropdowntree-item text="prices.pdf" sprite-css-class="pdf">
                            </dropdowntree-item>
                            <dropdowntree-item text="zip" sprite-css-class="folder">
                                <items>
                                    <dropdowntree-item  text="about.html" sprite-css-class="html">
                                    </dropdowntree-item>
                                    <dropdowntree-item text="index.html" sprite-css-class="html">
                                    </dropdowntree-item>
                                </items>
                            </dropdowntree-item>
                        </items>
                    </dropdowntree-item>
                </items>
            </dropdowntree-item>
        </items>
    </kendo-dropdowntree>
```

## Functionality and Features

| Feature                                                                                                                         | Description                                                                                                          |
| ------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- |
| [Data binding](https://www.telerik.com/aspnet-core-ui/documentation/html-helpers/editors/dropdowntree/binding/binding-overview) | The DropDownTree supports different data binding approaches.                                                         |
| [Checkboxes](https://www.telerik.com/aspnet-core-ui/documentation/html-helpers/editors/dropdowntree/checkboxes)                 | You can add checkboxes to the DropDownTree's items.                                                                  |
| [Filtering](https://www.telerik.com/aspnet-core-ui/documentation/html-helpers/editors/dropdowntree/filtering)                   | You are able to filter the displayed DropDownTree items by their text value.                                         |
| [Items](https://www.telerik.com/aspnet-core-ui/documentation/html-helpers/editors/dropdowntree/items)                           | You can configure different options for the items of the component.                                                  |
| [Templates](https://www.telerik.com/aspnet-core-ui/documentation/html-helpers/editors/dropdowntree/templates)                   | The DropDownTree supports customizing its look through templates.                                                    |
| [Accessibility](https://www.telerik.com/aspnet-core-ui/documentation/html-helpers/editors/dropdowntree/accessibility/overview)  | The DropDownTree is accessible by screen readers and provides WAI-ARIA, Section 508, WCAG 2.2, and keyboard support. |

## Next Steps

* [Getting Started with the DropDownTree](https://www.telerik.com/aspnet-core-ui/documentation/html-helpers/editors/dropdowntree/getting-started)

* [Basic Usage of the DropDownTree HtmlHelper for ASP.NET Core (Demo)](https://demos.telerik.com/aspnet-core/dropdowntree/index)

* [Basic Usage of the DropDownTree TagHelper for ASP.NET Core (Demo)](https://demos.telerik.com/aspnet-core/dropdowntree/tag-helper)

* [DropDownTree in Razor Pages](https://www.telerik.com/aspnet-core-ui/documentation/html-helpers/editors/dropdowntree/binding/razor-page)

## See Also

* [Using the API of the DropDownTree HtmlHelper for ASP.NET Core (Demo)](https://demos.telerik.com/aspnet-core/dropdowntree/api)
* [Knowledge Base Section](https://www.telerik.com/aspnet-core-ui/documentation/knowledge-base)
