Augustyniak / RATreeView

Library providing easy-to-use interface for displaying tree structures on iOS and tvOS.
MIT License
2.49k stars 464 forks source link

RATreeView (iOS 7.0+, tvOS 9.0+)

👷 Project created and maintained by Rafał Augustyniak. You can find me on twitter (@RaAugustyniak).

Introduction

Twitter: @raaugustyniak Build Status Carthage compatible CocoaPods Platform License: MIT

iOS tvOS

RATreeView is a class designed to provide easy and pleasant way to work with tree views on iOS and tvOS. It works as a wrapper for the UITableView, defining its own delegate and data source methods which make working with tree data structures really easy.

RATreeView is highly customizable and has a lot of features.

Installation

CocoaPods

CocoaPods is the recommended way to add RATreeView to your project.

  1. Add additional entry to your Podfile.

    pod "RATreeView", "~> 2.1.2"
  2. Install Pod(s) running pod install command.

  3. Include RATreeView using #import <RATreeView.h>.

Source files

  1. Downloaded the latest version of the library using link.
  2. Copy content of the downloaded (and unzipped) zip file into your project by dragging it into Project's navigator files structure.

Requirements

Usage

Check out the demo for example usage of library. Make sure you read the RATreeView documentation on Cocoa Docs.

Basics

  1. Add following import in file of your project when you want to use RATreeView:

    // In case you are using RATreeView with CocoaPods
    #import <RATreeView.h>
    // In case you are using RATreeView by simply copying 
    // source files of the RATreeView into your project
    #import "RATreeView.h"
  2. Simplest way to initialize and configure RATreeView:

    RATreeView *treeView = [[RATreeView alloc] initWithFrame:self.view.bounds];
    treeView.delegate = self;
    treeView.dataSource = self;       
    [self.view addSubview:treeView];
    [treeView reloadData];
  3. Implement required methods of the RATreeView's data source:

    - (NSInteger)treeView:(RATreeView *)treeView numberOfChildrenOfItem:(id)item
    {
       return item ? 3 : 0;
    }
    - (UITableViewCell *)treeView:(RATreeView *)treeView cellForItem:(id)item treeNodeInfo:(RATreeNodeInfo *)treeNodeInfo
    {
      // create and configure cell for *item*
      return cell
    }
    - (id)treeView:(RATreeView *)treeView child:(NSInteger)index ofItem:(id)item
    {
      return @(index);
    }

Adding Pull to Refresh control

Adding pull to refresh gesture is really easy using RATreeView and standard UIRefreshControl control.

UIRefreshControl *refreshControl = [UIRefreshControl new];
[refreshControl addTarget:self action:@selector(refreshControlChanged:) forControlEvents:UIControlEventValueChanged];
[treeView.scrollView addSubview:refreshControl];

Documentation

Documentation is available on CocoaPods.

TODO

Author

RATreeView was created by Rafał Augustyniak. You can find me on twitter (@RaAugustyniak).

Release Notes

Information about newer versions of the library can be found in the releases section of the repository.

Version 1.0.2

Version 1.0.1

Version 1.0.0

Version 0.9.2

Version 0.9.1

Version 0.9.0

License

MIT licensed, Copyright (c) 2014 Rafał Augustyniak, @RaAugustyniak