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

Downloads in past


4090.1.18 years ago8 years agoMinified + gzip package size for angular-ui-tree-filter in KB


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).