All docs
V20.2
24.1
23.2
23.1
22.2
22.1
21.2
21.1
20.2
20.1
19.2
The page you are viewing does not exist in version 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.
A newer version of this page is available. Switch to the current version.

jQuery TreeView - Search Nodes

Searching is disabled in the TreeView UI component by default. Assign true to the searchEnabled property to display the search panel. The searchExpr property specifies which data fields should be searched. Assign an array of field names to it if you need to search several fields.

jQuery
JavaScript
var treeViewData = [
    { key: '1', name: 'Fruits' },
    { key: '1_1', name: 'Apples', count: 20, parent: '1' },
    { key: '1_2', name: 'Oranges', count: 3, parent: '1' },
    { key: '2', name: 'Vegetables' },
    { key: '2_1', name: 'Cucumbers', count: 15, parent: '2' },
    { key: '2_2', name: 'Tomatoes', count: 23, parent: '2' }
];

$(function() {
    $("#treeViewContainer").dxTreeView({
        dataSource: treeViewData,
        dataStructure: 'plain',
        keyExpr: 'key',
        displayExpr: 'name',
        parentIdExpr: 'parent',
        searchEnabled: true,
        searchExpr: ["count", "name"]
    });
});
Angular
HTML
TypeScript
<dx-tree-view
    [dataSource]="treeViewData"
    dataStructure="plain"
    keyExpr="key"
    displayExpr="name"
    parentIdExpr="parent"
    [searchEnabled]="true"
    [searchExpr]="['count', 'name']">
</dx-tree-view>
import { DxTreeViewModule } from "devextreme-angular";
// ...
export class AppComponent {
    treeViewData = [
        { key: '1', name: 'Fruits' },
        { key: '1_1', name: 'Apples', count: 20, parent: '1' },
        { key: '1_2', name: 'Oranges', count: 3, parent: '1' },
        { key: '2', name: 'Vegetables' },
        { key: '2_1', name: 'Cucumbers', count: 15, parent: '2' },
        { key: '2_2', name: 'Tomatoes', count: 23, parent: '2' }
    ];
}
@NgModule({
     imports: [
         // ...
         DxTreeViewModule
     ],
     // ...
 })
Vue
App.vue
<template>
    <DxTreeView
        data-structure="plain"
        :data-source="treeViewData" 
        key-expr="key"
        display-expr="name"
        parent-id-expr="parent"
        :search-enabled="true"
        :search-expr="searchExpr"  
    />
</template>
<script>
import 'devextreme/dist/css/dx.common.css';
import 'devextreme/dist/css/dx.light.css';

import { DxTreeView } from 'devextreme-vue/tree-view';

const treeViewData = [
    { key: '1', name: 'Fruits' },
    { key: '1_1', name: 'Apples', count: 20, parent: '1' },
    { key: '1_2', name: 'Oranges', count: 3, parent: '1' },
    { key: '2', name: 'Vegetables' },
    { key: '2_1', name: 'Cucumbers', count: 15, parent: '2' },
    { key: '2_2', name: 'Tomatoes', count: 23, parent: '2' }
];

export default {
    components: {
        DxTreeView
    },
    data() {
        return {
            searchExpr: ['count', 'name'],
            treeViewData
        };
    },
};
</script>
React
App.js
import React from 'react';

import 'devextreme/dist/css/dx.common.css';
import 'devextreme/dist/css/dx.light.css';

import TreeView from 'devextreme-react/tree-view';

const treeViewData = [
    { key: '1', name: 'Fruits' },
    { key: '1_1', name: 'Apples', count: 20, parent: '1' },
    { key: '1_2', name: 'Oranges', count: 3, parent: '1' },
    { key: '2', name: 'Vegetables' },
    { key: '2_1', name: 'Cucumbers', count: 15, parent: '2' },
    { key: '2_2', name: 'Tomatoes', count: 23, parent: '2' }
];

const searchExpr = ["count", "name"];
class App extends React.Component {
    render() {
        return (
            <TreeView
                dataStructure="plain"
                dataSource={treeViewData}
                keyExpr="key"
                displayExpr="name"
                parentIdExpr="parent"
                searchEnabled={true}
                searchExpr={searchExpr} />
        );
    }
}

export default App;

View Demo

When a user types a string in the input field, the TreeView suggests all nodes that contain this string. Assign 'startswith' to the searchMode property if you want the TreeView to suggest only those nodes that start with the input string.

jQuery
JavaScript
$(function() {
    $("#treeViewContainer").dxTreeView({
        dataSource: treeViewData,
        dataStructure: 'plain',
        keyExpr: 'key',
        displayExpr: 'name',
        parentIdExpr: 'parent',
        searchEnabled: true,
        searchMode: "startswith"
    });
});
Angular
HTML
TypeScript
<dx-tree-view
    [dataSource]="treeViewData"
    dataStructure="plain"
    keyExpr="key"
    displayExpr="name"
    parentIdExpr="parent"
    [searchEnabled]="true"
    searchMode="startswith">
</dx-tree-view>
import { DxTreeViewModule } from "devextreme-angular";
// ...
export class AppComponent {
    treeViewData = [
        { key: '1', name: 'Fruits' },
        { key: '1_1', name: 'Apples', count: 20, parent: '1' },
        { key: '1_2', name: 'Oranges', count: 3, parent: '1' },
        { key: '2', name: 'Vegetables' },
        { key: '2_1', name: 'Cucumbers', count: 15, parent: '2' },
        { key: '2_2', name: 'Tomatoes', count: 23, parent: '2' }
    ];
}
@NgModule({
     imports: [
         // ...
         DxTreeViewModule
     ],
     // ...
 })
Vue
App.vue
<template>
    <DxTreeView
        data-structure="plain"
        :data-source="treeViewData" 
        key-expr="key"
        display-expr="name"
        parent-id-expr="parent"
        search-mode="startswith"
        :search-enabled="true"
        :search-expr="searchExpr"  
    />
</template>
<script>
import 'devextreme/dist/css/dx.common.css';
import 'devextreme/dist/css/dx.light.css';

import { DxTreeView } from 'devextreme-vue/tree-view';

const treeViewData = [
    { key: '1', name: 'Fruits' },
    { key: '1_1', name: 'Apples', count: 20, parent: '1' },
    { key: '1_2', name: 'Oranges', count: 3, parent: '1' },
    { key: '2', name: 'Vegetables' },
    { key: '2_1', name: 'Cucumbers', count: 15, parent: '2' },
    { key: '2_2', name: 'Tomatoes', count: 23, parent: '2' }
];

export default {
    components: {
        DxTreeView
    },
    data() {
        return {
            searchExpr: ['count', 'name'],
            treeViewData
        };
    },
};
</script>
React
App.js
import React from 'react';

import 'devextreme/dist/css/dx.common.css';
import 'devextreme/dist/css/dx.light.css';

import TreeView from 'devextreme-react/tree-view';

const treeViewData = [
    { key: '1', name: 'Fruits' },
    { key: '1_1', name: 'Apples', count: 20, parent: '1' },
    { key: '1_2', name: 'Oranges', count: 3, parent: '1' },
    { key: '2', name: 'Vegetables' },
    { key: '2_1', name: 'Cucumbers', count: 15, parent: '2' },
    { key: '2_2', name: 'Tomatoes', count: 23, parent: '2' }
];

const searchExpr = ["count", "name"];
class App extends React.Component {
    render() {
        return (
            <TreeView
                dataStructure="plain"
                dataSource={treeViewData}
                keyExpr="key"
                displayExpr="name"
                parentIdExpr="parent"
                searchMode="startswith"
                searchEnabled={true}
                searchExpr={searchExpr} />
        );
    }
}

export default App;

You can customize the search panel by specifying the searchEditorOptions property. The following code changes the panel's default width and placeholder:

jQuery
JavaScript
$(function() {
    $("#treeViewContainer").dxTreeView({
        dataSource: treeViewData,
        dataStructure: 'plain',
        keyExpr: 'key',
        displayExpr: 'name',
        parentIdExpr: 'parent',
        searchEnabled: true,
        searchEditorOptions: {
            placeholder: "Type search value here...",
            width: 300
        }
    });
});
Angular
HTML
TypeScript
<dx-tree-view
    [dataSource]="treeViewData"
    dataStructure="plain"
    keyExpr="key"
    displayExpr="name"
    parentIdExpr="parent"
    [searchEnabled]="true">
    <dxo-search-editor-options
        placeholder="Type search value here..."
        [width]="300">
    </dxo-search-editor-options>
</dx-tree-view>
import { DxTreeViewModule } from "devextreme-angular";
// ...
export class AppComponent {
    treeViewData = [
        { key: '1', name: 'Fruits' },
        { key: '1_1', name: 'Apples', count: 20, parent: '1' },
        { key: '1_2', name: 'Oranges', count: 3, parent: '1' },
        { key: '2', name: 'Vegetables' },
        { key: '2_1', name: 'Cucumbers', count: 15, parent: '2' },
        { key: '2_2', name: 'Tomatoes', count: 23, parent: '2' }
    ];
}
@NgModule({
     imports: [
         // ...
         DxTreeViewModule
     ],
     // ...
 })
Vue
App.vue
<template>
    <DxTreeView
        data-structure="plain"
        :data-source="treeViewData" 
        key-expr="key"
        display-expr="name"
        parent-id-expr="parent"
        :search-enabled="true">
        <DxSearchEditorOptions
            placeholder="Type search value here..."
            :width="300"
        />
    </DxTreeView>    
</template>
<script>
import 'devextreme/dist/css/dx.common.css';
import 'devextreme/dist/css/dx.light.css';

import DxTreeView, {
    DxSearchEditorOptions
} from 'devextreme-vue/tree-view';

const treeViewData = [
    { key: '1', name: 'Fruits' },
    { key: '1_1', name: 'Apples', count: 20, parent: '1' },
    { key: '1_2', name: 'Oranges', count: 3, parent: '1' },
    { key: '2', name: 'Vegetables' },
    { key: '2_1', name: 'Cucumbers', count: 15, parent: '2' },
    { key: '2_2', name: 'Tomatoes', count: 23, parent: '2' }
];

export default {
    components: {
        DxTreeView,
        DxSearchEditorOptions
    },
    data() {
        return {
            treeViewData
        };
    },
};
</script>
React
App.js
import React from 'react';

import 'devextreme/dist/css/dx.common.css';
import 'devextreme/dist/css/dx.light.css';

import { TreeView, SearchEditorOptions } from 'devextreme-react/tree-view';

const treeViewData = [
    { key: '1', name: 'Fruits' },
    { key: '1_1', name: 'Apples', count: 20, parent: '1' },
    { key: '1_2', name: 'Oranges', count: 3, parent: '1' },
    { key: '2', name: 'Vegetables' },
    { key: '2_1', name: 'Cucumbers', count: 15, parent: '2' },
    { key: '2_2', name: 'Tomatoes', count: 23, parent: '2' }
];

class App extends React.Component {
    render() {
        return (
            <TreeView
                dataStructure="plain"
                dataSource={treeViewData}
                keyExpr="key"
                displayExpr="name"
                parentIdExpr="parent"
                searchEnabled={true}>
                <SearchEditorOptions
                    placeholder="Type search value here..."
                    width={300}
                />                    
            </TreeView>    
        );
    }
}

export default App;
See Also