Package Exports

react-treebeard
react-treebeard/lib/components/treebeard

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (react-treebeard) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

react-treebeard

React Tree View Component. Fast, Efficient and Customisable.

Install

npm install react-treebeard --save

Example

'use strict';

import React from 'react';
import ReactDOM from 'react-dom';
import Treebeard from 'react-treebeard';

const data = {
    id: 0,
    name: 'root',
    toggled: true,
    children: [
        {
            id: 1,
            name: 'parent',
            children: [
                {
                    id: 2,
                    name: 'child',
                    terminal: true
                }
            ]
        },
        {
            id: 3,
            name: 'loading parent',
            loading: true
        },
        {
            id: 4,
            name: 'parent',
            children: [
                {
                    id: 5,
                    name: 'nested parent',
                    children: [
                        {
                            id: 6,
                            name: 'nested child',
                            terminal: true
                        }
                    ]
                }
            ]
        }
    ]
};

class TreeExample extends React.Component {
    constructor(props){
        super(props);
    }
    onToggle(/* node, toggled */){
        // ...
    }
    render(){
        return (
            <Treebeard
                data={data}
                onToggle={this.onToggle}
            />
        );
    }
}

const content = document.getElementById('content');
ReactDOM.render(<TreeExample/>, content);

Prop Values

data

React.PropTypes.object.isRequired

Data that drives the tree view. State-driven effects can be built by manipulating the attributes in this object. An example can be found in example/data.js

onToggle

React.PropTypes.func

Callback function when a node is toggled / clicked. Passes 2 attributes: the data node and it's toggled boolean state.

style

React.PropTypes.object

Sets the treeview styling. Defaults to src/themes/default.

animations

React.PropTypes.object

Sets the treeview animations. See velocity-react for more details. Defaults to src/themes/animations.

decorators

React.PropTypes.object

Decorates the treeview. Here you can use your own Node Header, Toggle and Loading components. Defaults to src/decorators. See example below:

let decorators = {
    Loading: (props) => {
        return (
            <div style={props.style}>
                loading...
            </div>
        );
    },
    Toggle: (props) => {
        return (
            <div style={props.style}>
                <svg height={props.height} width={props.width}>
                    // Vector Toggle Here
                </svg>
            </div>
        );
    },
    Header: (props) => {
        return (
            <div style={props.style}>
                {props.name}
            </div>
        );
    }
};

<Treebeard data={...} decorators={decorators}/>

Data Attributes

{
    id: 'string/number',
    name: 'string',
    children: 'array',
    loading: 'boolean',
    terminal: 'boolean',
    decorators: 'object',
    animations: 'object'
},

id

The unique identifier for the node. Treebeard uses this value to efficiently build the treeview.

name

The name prop passed into the Header component.

children

The children attached to the node. This value populates the subtree at the specific node. Each child is built from the same basic data structure.

loading

Loading flag. It will populate the treeview with the loading component. Useful when asynchronously pulling the data into the treeview.

terminal

Terminates the node. There is no more data to load into the subtree. A Toggle will not be rendered. This is the end of the path.

decorators / animations

Attach specific decorators / animations to a node. Provides the low level functionality to create visuals on a node-by-node basis. These structures are the same as the top level props, described above.