A module providing an AngularJS filter which can be used with angular-ui-tree to match tree nodes.


Angular Core Dependency: >= 1.2.0

Module License: MIT

Added by: Sam Deering





Stars: 32

Watchers: 32

Forks: 12

Module Description

#ui.tree-filter Build Status Built with Grunt

A module providing an AngularJS filter which can be used with angular-ui-tree to match tree nodes.

**Table of Contents** *generated with [DocToc](*

How it works?

  1. It's is configurable:
  • you may provide default properties of your nodes that should matched against provided pattern:
  .config(function (uiTreeFilterSettingsProvider) {
    uiTreeFilterSettingsProvider.addresses = ['title', 'description', 'username'];
  • or you may pass property list as an optional 3rd argument:
$filter('uiTreeFilter')(nodeObject, pattern, ['title', 'description', 'username'])
  1. It matches the whole path If a sub-node matches all its ancestors up to the tree root match as well:
Filtered string: "the matched string"

    1. Foo
    2. Bar                            # matches as one of its descendants matches
        2.1 Baz                       # matches as one of its descendants matches
            2.1.1 The matched string  # matches exactly

How to use?

Filter can be used in the template to as an argument of the ng-show or ng-if.

<input ng-model="pattern">
<script type="text/ng-template" id="items_renderer.html">
  <div ui-tree-handle>{{item.title}}</div>
  <ol ui-tree-nodes ng-model="item.items">
    <li ng-repeat="item in item.items" ui-tree-node ng-include="'items_renderer.html'" 
        ng-hide="filter(item, pattern)">
<div ui-tree>
  <ol ui-tree-nodes ng-model="list">
    <li ng-repeat="item in list" ui-tree-node ng-include="'items_renderer.html'" 
        ng-hide="filter(item, pattern)"></li>

Configuration reference

  • addresses (default: ['title']): properties of notes against which pattern will be matched. Deep filed access is supported: one can provide to match against value.
  • regexFlags (default: 'gi'): Regular expression flags applied during he matching
  • descendantCollection (default: 'items'): name of item property that holds item descendants


The filter is not provided with any performance improving mechanisms. It may turn out suboptimal for large trees with thousands of nodes and. If you need it to become perform better let us know what your case is by filing an issue


Basically all the browsers down to Firefox 3.0, IE 9, Opera 10.5 and Safari 4.0 are supported.

Potential support blockers:

  • Array.reduce support: Fx 3, IE 9, Op 10.5, Sf4
  • Array.forEach support IE 9

If you wish to support IE8 (as AngularJS 1.2.x do) you'd have to provide proper polyfills. But you know it anyway


The module is available under the MIT license (see LICENSE for details).

Module stats last updated: 2017-12-06 16:00:03

Disclaimer: Some data on this page may have been gathered from the authors GitHub respository. If you see any mistakes or outdated information please let us know. Thanks!