/angular2-tree-component

A simple yet powerful tree component for Angular2 - https://angular2-tree.readme.io/docs

Primary LanguageTypeScriptMIT LicenseMIT

npm version

angular2 tree component

A full featured tree component for Angular 2

We've built so many projects that required a tree component, and could never find a library that supported all features. And building your own tree component is not an easy task.

So, we decided to build one for Angular 2, with all the features you can think of:

  • Simple to use
  • Well Documented
  • Keyboard navigation
  • Async data
  • Drag & Drop
  • Select & Multiselect
  • Filtering
  • Customizable (override field names, custom templates, etc...)
  • Event callbacks
  • API for accessing & altering the tree state
  • Easily styled (comes with very minimal styling)

If you like this, support the project by starring it!

Angular 2 supported version

angular2-tree-component supports angular 2.X.X releases, and AoT compilation.

Getting started, demo & full documentation

Please refer to the full documentation:
https://angular2-tree.readme.io/docs

Call for styles

Hello users & contributors of the tree.

We're looking for nice example themes for the tree. If you've made one, and are willing to share, please open an issue and attach your CSS and image of how it should look.

Thanks

Example

To run the example:

git clone https://github.com/500tech/angular2-tree-component

cd angular2-tree-component/example/cli
npm install
npm install -g angular-cli
ng serve

SystemJS

There's currently an issue with systemJS and lodash.
Until we solve it, please install lodash into the project:

npm install --save lodash

and add these lines to systemjs.config.js:

  var map = {
    'angular2-tree-component':    'node_modules/angular2-tree-component',
    'lodash':                     'node_modules/lodash',
  };

  var packages = {
    'angular2-tree-component'   : { main: 'dist/angular2-tree-component.js', defaultExtension: 'js' },
    'lodash'                    : { main: 'lodash.js', defaultExtension: 'js' },
  };

What's next

We would always love to hear suggestions for features & improvements - just open an issue.

Some things on our mind down the road:

  • virtual scroll (WIP)
  • context menu
  • save & restore tree state
  • checkbox & master checkbox support

Contributing

There are currently no unit tests (yet).

However, if you wish to contribute code, you can run npm run example:cli and open localhost:4200 to test your code manually before submitting a pull request.

Please email me at adam@500tech.com before starting to work on a feature / bug to make sure it's something that I'm not working on already.