# TreeView

**Repository Path**: baijuncheng-open-source/tree-view

## Basic Information

- **Project Name**: TreeView
- **Description**:  这是一个具有高性能和丰富功能的树状列表图组件
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2021-04-28
- **Last Updated**: 2021-07-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# TreeView
An tree view with high performance and rich functions 

## Captures

There are some gifs from Demo:

- Select node:

![img](/images/show_demo_select.gif)

- Operate all:

![img](/images/show_demo_more_featrue.gif)

## Features
- expandAll/collapseAll
- expandNode/collapseNode
- expandLevel/collapseLevel
- toggleNode
- deleteNode/addNode
- selectNode/deselectNode
- selectAll/deselectAll
- getSelectedNodes
- refreshTreeView

## Usage
1. Add the following code inside Gradle of Entry (just Demo)

 ```
 implementation fileTree(dir: 'libs', include: ['*.jar', '*.har'])
 ```
2. Add this in your root `build.gradle` file (**not** your module `build.gradle` file):
```xml
allprojects {
	repositories {
		...
		mavenCentral()
	}
}
```
2. The lib is available on Maven Central, you can find it with [Gradle, please]
```xml
dependencies {
    implementation ‘com.gitee.baijuncheng-open-source:tree-view:1.0.0'
}
```

Sample：
```java
public class FirstLevelNodeViewBinder extends CheckableNodeViewBinder {

    Text textView;
    Image imageView;
    public FirstLevelNodeViewBinder(Component itemView) {
        super(itemView);
        textView = (Text) itemView.findComponentById(ResourceTable.Id_node_name_view);
        imageView = (Image) itemView.findComponentById(ResourceTable.Id_arrow_img);
    }

    @Override
    public int getCheckableViewId() {
        return ResourceTable.Id_checkBox;
    }

    @Override
    public void bindView(final TreeNode treeNode) {
        textView.setText(treeNode.getValue().toString());
        imageView.setRotation(treeNode.isExpanded() ? 90 : 0);
        imageView.setVisibility(treeNode.hasChild() ? Component.VISIBLE : Component.INVISIBLE);
    }

    @Override
    public void onNodeToggled(TreeNode treeNode, boolean expand) {
        if (expand) {
            imageView.createAnimatorProperty().rotate(90).setDuration(200).start();
        } else {
            imageView.createAnimatorProperty().rotate(0).setDuration(200).start();
        }
    }
}

SecondLevelNodeViewBinder
ThirdLevelNodeViewBinder

```
If you want add the selectable feature,replace BaseNodeViewBinder with CheckableNodeViewBinder.

**3.Implement the BaseNodeViewFactory**

Sample：
```java
public class MyNodeViewFactory extends BaseNodeViewFactory {
  @Override
  public BaseNodeViewBinder getNodeViewBinder(Component view, int level) {
    switch (level) {
      case 0:
        return new FirstLevelNodeViewBinder(view);
      case 1:
        return new SecondLevelNodeViewBinder(view);
      case 2:
        return new ThirdLevelNodeViewBinder(view);
      default:
        return null;
    }
  }
}
```
If you do not want to create a class file,just implement a anonymous inner class in TreeView's constructor

**4.Add TreeView to wherever you want**

Sample:
```java
TreeNode root = TreeNode.root();
//build the tree as you want
for (int i = 0; i < 5; i++) {
  TreeNode treeNode = new TreeNode(new String("Child " + "No." + i));
  treeNode.setLevel(0);
  root.addChild(treeNode);
}
Component treeView = new TreeView(root, context, new MyNodeViewFactory()).getView();
//add to view group where you want 
```
## Change Log

### [1.0] - April, 2021

- 新增TreeView库；
## License

    Copyright 2017 shineM.

    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.
    You may obtain a copy of the License at
    
       http://www.apache.org/licenses/LICENSE-2.0
    
    Unless required by applicable law or agreed to in writing, software
    distributed under the License is distributed on an "AS IS" BASIS,
    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    See the License for the specific language governing permissions and
    limitations under the License.