Tree2View

TreeView implementation in Android.Now available on Jitpack:tada:

中文版

Features

TreeView	File Explorer(Advanced Example)
①Multi-level tree view	Basic file manager layout
②Remember expansion state	Automatically expand the last unclosed directory
③Customize TreeAdapter	Different types of documents show different Icon
④Dynamic add and delete nodes	refresh status after delete and add files
⑤Select listener	Long press node for file operations (Copy, Cut, Rename, Delete)
⑥Animation support	Add or delete files with animation

You can also see a more simple example.

Implement

• TreeView extends from ListView.

• DFS travel the expandable tree node, and convert it to List which adapt with TreeAdapter.

• Use SimpleTreeAdapter ot set different indentation on nodes of different depths.

• Use LinkedList to store node’s children, see DefaultTreeNode.

Preview

Download

1. Add it in your root build.gradle at the end of repositories:

	allprojects {
		repositories {
			...
			maven { url 'https://jitpack.io' }
		}
	}

1. Add the dependency

	dependencies {
	        implementation 'com.github.LeeReindeer:Tree2View:v0.1.2'
	}

Usage

1. Add in your xml:

Feel free to use it as ListView.

    <moe.leer.tree2view.TreeView
        android:id="@+id/tree_view"
        android:layout_marginTop="16dp"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:divider="#ffffff"
        android:dividerHeight="1px">

    </moe.leer.tree2view.TreeView>

1. Add children in Kotlin code(Java is similar whit it)

     var root :DefaultTreeNode? = DefaultTreeNode("Root")
     tree_view.root = root
     val child1 = DefaultTreeNode("Child1")
     val child2 = DefaultTreeNode("Child2")
     // After create a node your should immediately add it.
     root.addChild(child1)
     root.addChild(child2)
     val child3 = DefaultTreeNode("Child3")
     child1.addChild(child3)
     //whether the root's children is expanded by default
     tree_view.isRootVisible = true
     //animation
     tree_view.isDefaultAnimation = true
   

2. Add click listener and select listener

Tree2View has a default click listener, but it’s ok to add your own.You can refer to here.

1. If you want to use customized item view, you should implement TreeAapater, like this:

   public class FileTreeAdapter extends TreeAdapter<FileItem> {
     //resourceId is your customized view resourceId, please use RelativeLayout, and let view neighbour.
     public FileTreeAdapter(Context context, DefaultTreeNode root, int resourceId) {
    super(context, root, resourceId);
     }
     
    @Override
    public View getView(int position, View convertView, ViewGroup parent) {
     //your code here
     //...
     //call padding for a better UI
     setPadding(holder.arrowIcon, depth, -1);
     //toggle your view's status here
     toggle(node, holder);
    }
       
    @Override
     public void toggle(Object... objects) {
     }
   

Then simply add:

  val adapter = FileTreeAdapter(this@MainActivity, root, R.layout.layout_file_tree_item)
  treeView.treeAdapter = adapter

License

Apache 2.0