SPXRevealableView 0.2

SPXRevealableView 0.2

TestsTested
LangLanguage Obj-CObjective C
License MIT
ReleasedLast Release Dec 2014

Maintained by Shaps.




Purpose

I recently needed to build the iMessage style pull-to-reveal timestamps feature for a personal project and decided to open source the category. :)

Supported OS & SDK Versions

  • Supported build target - iOS 6.0
  • Earliest supported deployment target - iOS 6.0

ARC Compatibility

The category will work correctly ONLY with ARC enabled.

Installation

To install, either copy the category UITableView+SPXRevealAdditions.h into your project or add it to your podfile.

pod 'SPXRevealableView'

Usage

Using this component is almost completely drop in, just follow a few simple steps:

    1. #import "UITableView+SPXRevealAdditions.h"
    2. [self.tableView enableRevealableViewForDirection:SPXRevealableViewGestureDirectionLeft];
    3. cell.revealableView = timestampView;

You should call enable at a fairly early stage in your UITableView's lifecycle, ideally in -viewDidLoad

The revealableView size is based on the XIB it was loaded from. The height will always match the cell, but the width will be maintained from the views frame ;)

To gain the benefits of reusable cells, I recommended setting the revealableView in your -awakeFromNib cell method, but you could declare it directly in your -cellForRowAtIndexPath method as is shown in the included demo.

That's it! It will automatically handle inserting the view into the cells, you have a nice property on each cell to make it simple to update and all gesture handling is done automatically for you just by including the class.

Feel free to use in any way you see fit. Please try and reference me somewhere in your app if you use this in a production app and maybe even tell me about it via Twitter @shaps ;)

Screenshot