English | 简体中文

treeify.js is a tool for converting an array which each element contains the same specific rules into an object.

$ npm install --save-dev treeify-js

[unpkg] https://unpkg.com/treeify-js 

Packages gulp and mocha should already be installed globally. You should also run $ npm install first to install all dependencies.

Run the build script to build, and the test script to run unit test.

$ npm run build

So, now we have an array:

var arr = [ { id: 'a1', parentId: 'a' }, { id: 'aq', parentId: 'a2' }, { id: 'a2', parentId: 'a' }, { id: 'a1-1', parentId: 'a1' }, { id: 'a', parentId: '' } ];

Then, You need to convert to such a tree object:

 { id: 'a', parentId: '', children: [ { id: 'a1', parentId: 'a', children: [ { id: 'a1-1', parentId: 'a1', children: [] } ] }, { id: 'a2', parentId: 'a', children: [ { id: 'aq', parentId: 'a2', children: [] } ] } ] } 

You just need to give the array to treeify:

import { treeify } from 'treeify-js' treeify(arr);

Then, you get what you want, It's an easy work.

Check the unit tests to get more usage.

Enjoy!

• treeify(data, configure)

  Convert an array to a tree object. An array which as data source, all element of it must be an object that has an unique ID and a parent's ID.

  • data Array - Give a data which Array type to treeify
  • configure Object - A Object that Configure keys name mapping in convertion. The most common usage is no any configuration, just give the data along.
    • id: string|Function - default value is "id".
    • parentId: string|Function - default value is "parentId".
    • children: string|Function - default value is "children".
    • root: any type - specify a value directly, the value can be any type, if return a value which an array type, it means 'contains', such as { root: () => ["xxxx"] }, it is the same as { root: () => "xxxx" } if only one value is returned. default value is null.
    • multi: boolean - If the 'multi' is set * to TRUE, it can have multiple roots, FALSE can only have one, default value is false.
    • deepClone: boolean - Whether deep clone all elements of data in convert, default value is false.

• untreeify(tree, childrenName)

  Convert a tree from treeify() back into an array. This is the inverse of treeify.

  • tree Object - A tree comes from treeify
  • childrenName String|Function - Give the children's key name, it can also be a function. default value is "children"

treeify is under MIT licensed.