# TreeView

**Repository Path**: baijuncheng-open-source_admin/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 android tree view with high performance and rich functions 

[中文介绍](http://texy.me/2017/05/01/android_tree_view/)

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

### Usage
**1.Reference the library from your module's build.gradle:**
```groovy
implementation 'com.qw.curtain.treeview_lib:treeview_lib:1.0.6'
```
**2.Implement your all level's BaseNodeViewBinder**

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(View 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);
}
View treeView = new TreeView(root, context, new MyNodeViewFactory()).getView();
//add to view group where you want 
```

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