https://github.com/jamztang/JTGestureBasedTableViewDemo

(demo) Recreating the buttonless interaction pattern found in Clear for iPhone app
https://github.com/jamztang/JTGestureBasedTableViewDemo

Last synced: 2 months ago
JSON representation

(demo) Recreating the buttonless interaction pattern found in Clear for iPhone app

• Host: GitHub
• URL: https://github.com/jamztang/JTGestureBasedTableViewDemo
• Owner: jamztang
• Created: 2012-02-15T06:34:59.000Z (almost 13 years ago)
• Default Branch: master
• Last Pushed: 2019-11-26T18:15:43.000Z (about 5 years ago)
• Last Synced: 2024-10-29T19:58:19.192Z (3 months ago)
• Language: Objective-C
• Homepage: http://jamztang.com
• Size: 699 KB
• Stars: 1,332
• Watchers: 91
• Forks: 201
• Open Issues: 13
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

• awesome - JTGestureBasedTableViewDemo - (demo) Recreating the buttonless interaction pattern found in Clear for iPhone app (etc)
• awesome - JTGestureBasedTableViewDemo - (demo) Recreating the buttonless interaction pattern found in Clear for iPhone app (etc)

README

        
JTGestureBasedTableView

=======================

An iOS objective-c library template to recreate the gesture based interaction found from Clear for iPhone app.

This project is aimed to be a truely flexible solution, but currently it's still in development stage and missing a few features.

The library now requires iOS 5.0 with ARC, please use -fobjc-arc compiler flag to add support for non-ARC projects.

Known Issues

------------

It has been developed under iOS 4.3 and 5.0 devices, sample code has been built using ARC (not quite properly). I am still studying to have a proper refactor on my code for a real ARC adoption. 

There's currently one known issues related to running on non-arc enviornment (e.g. refs #4). Please use `-fobjc-arc` per source file complier flag for compiling on non-ARC enviroment.

Abstract

--------

Clear for iPhone app has showed us so much we can do with a buttonless interface, and I am trying to reveal the technique behind the gesture based interaction, hopefully can heavy-lifted all of us whom trying to achieve the same.

Demo

----











Features

--------

It only supports few features at the moment.

- Pull down to add cell

- Pinch to create cell

- Panning on cell gesture

- Long hold to reorder cell

- Pull to return to List (Thanks [SungDong Kim][] for making this happen)

10 Jan 2013 Update:

- Better pinch animation and iPhone 5 screen support (Big thanks for [Lukas Foldyna][] for refactor and polishing!)

How To Use It

-------------

### Installation

Include all header and implementation files in JTGestureBasedTabeView/ into your project, and also links the QuartzCore framework to your target.

### Setting up your UITableView for your viewController

    #import "JTTableViewGestureRecognizer.h"

    

    @interface ViewController () 

    @property (nonatomic, strong) NSMutableArray *rows;

    @property (nonatomic, strong) JTTableViewGestureRecognizer *tableViewRecognizer;

    @end

    

    @implementation ViewController

    @synthesize tableViewRecognizer;

    

    - (void)viewDidload {

        /*

        :

        */

    

        // In our examples, we setup self.rows as datasource

        self.rows = ...;

        

        // Setup your tableView.delegate and tableView.datasource,

        // then enable gesture recognition in one line.

        self.tableViewRecognizer = [self.tableView enableGestureTableViewWithDelegate:self];

    }

### Enabling adding cell gestures

    // Conform to JTTableViewGestureAddingRowDelegate to enable features

    // - drag down to add cell

    // - pinch to add cell

    @protocol JTTableViewGestureAddingRowDelegate 

    - (void)gestureRecognizer:(JTTableViewGestureRecognizer *)gestureRecognizer needsAddRowAtIndexPath:(NSIndexPath *)indexPath;

    - (void)gestureRecognizer:(JTTableViewGestureRecognizer *)gestureRecognizer needsCommitRowAtIndexPath:(NSIndexPath *)indexPath;

    - (void)gestureRecognizer:(JTTableViewGestureRecognizer *)gestureRecognizer needsDiscardRowAtIndexPath:(NSIndexPath *)indexPath;

    @optional

    - (NSIndexPath *)gestureRecognizer:(JTTableViewGestureRecognizer *)gestureRecognizer willCreateCellAtIndexPath:(NSIndexPath *)indexPath;

    - (CGFloat)gestureRecognizer:(JTTableViewGestureRecognizer *)gestureRecognizer heightForCommittingRowAtIndexPath:(NSIndexPath *)indexPath;

    @end

### Enabling editing cell gestures

    // Conform to JTTableViewGestureEditingRowDelegate to enable features

    // - swipe to edit cell

    @protocol JTTableViewGestureEditingRowDelegate 

    // Panning (required)

    - (BOOL)gestureRecognizer:(JTTableViewGestureRecognizer *)gestureRecognizer canEditRowAtIndexPath:(NSIndexPath *)indexPath;

    - (void)gestureRecognizer:(JTTableViewGestureRecognizer *)gestureRecognizer didEnterEditingState:(JTTableViewCellEditingState)state forRowAtIndexPath:(NSIndexPath *)indexPath;

    - (void)gestureRecognizer:(JTTableViewGestureRecognizer *)gestureRecognizer commitEditingState:(JTTableViewCellEditingState)state forRowAtIndexPath:(NSIndexPath *)indexPath;

    @optional

    - (CGFloat)gestureRecognizer:(JTTableViewGestureRecognizer *)gestureRecognizer lengthForCommitEditingRowAtIndexPath:(NSIndexPath *)indexPath;

    - (void)gestureRecognizer:(JTTableViewGestureRecognizer *)gestureRecognizer didChangeContentViewTranslation:(CGPoint)translation forRowAtIndexPath:(NSIndexPath *)indexPath;

    @end

### Enabling reorder cell gestures

    // Conform to JTTableViewGestureMoveRowDelegate to enable features

    // - long press to reorder cell

    @protocol JTTableViewGestureMoveRowDelegate 

    - (BOOL)gestureRecognizer:(JTTableViewGestureRecognizer *)gestureRecognizer canMoveRowAtIndexPath:(NSIndexPath *)indexPath;

    - (void)gestureRecognizer:(JTTableViewGestureRecognizer *)gestureRecognizer needsCreatePlaceholderForRowAtIndexPath:(NSIndexPath *)indexPath;

    - (void)gestureRecognizer:(JTTableViewGestureRecognizer *)gestureRecognizer needsMoveRowAtIndexPath:(NSIndexPath *)sourceIndexPath toIndexPath:(NSIndexPath *)destinationIndexPath;

    - (void)gestureRecognizer:(JTTableViewGestureRecognizer *)gestureRecognizer needsReplacePlaceholderForRowAtIndexPath:(NSIndexPath *)indexPath;

    @end

### You choose what to enable

You can pick what gestures to be enabled by conforming to the appropriate protocols.

Don't forget to look at JTGestureBasedTableViewDemo/ViewController.m for a complete working usage.

License

-------

This project is under MIT License, please feel free to contribute and use it.

James

[SungDong Kim]:https://github.com/acroedit

[Lukas Foldyna]:https://github.com/augard

[![Bitdeli Badge](https://d2weczhvl823v0.cloudfront.net/jamztang/jtgesturebasedtableviewdemo/trend.png)](https://bitdeli.com/free "Bitdeli Badge")