Note: this library comes out as an abstraction of former PDGestureTableView's cell swiping logic. Since it's based on UIPanGestureRecognizer class, now there's a total independency on which UITableView and UITableViewCell classes it can interact with.
- UITableView/UITableViewCell class agnostic.
- Setup multiple actions for multiple cell fractions.
- Fully customizable.
Drag and copy all files in the DRCellSlideGestureRecognizer folder into your project.
At a glance
Setting up actions
Setting up an action is really simple, although you'll need a
DRCellSlideGestureRecognizer instance to add them to first:
DRCellSlideGestureRecognizer *gestureRecognizer = [DRCellSlideGestureRecognizer new];
Then, simply instantiate
DRCellSlideAction like this:
DRCellSlideAction *action = [DRCellSlideAction actionForFraction:0.25]; action.behavior = DRCellSlideActionPushBehavior; action.icon = [UIImage imageNamed:@"imageName"];
fraction determines the part of the cell to where the action will become active and ready to be triggered.
And finally, add the action to the gesture recognizer, and the gesture recognizer to the cell:
[gestureRecognizer addActions:action]; [cell addGestureRecognizer:gestureRecognizer];
Note: the given instructions should be performed inside tableView:cellForRowAtIndexPath: method.
There are multiple
DRCellSlideAction properties available for you to customize the appearence and interactivity of the cell:
behavior: how the action will behave once triggered by the user. Possible values:
DRCellSlideActionPullBehavior: the cell returns to its original position.
DRCellSlideActionPushBehavior: the cell is pushed to the edge of the table.
icon: the image to be displayed for the action.
iconMargin: the margin for the icon.
activeColor: the color of
iconwhen the action is active.
inactiveColor: the color of
iconwhen the action is inactive.
activeBackgroundColor: the background color when the action is active.
inactiveBackgroundColor: the background color when the action is inactive.
elasticity: the amount of elastic resistence for the cell to be dragged.
willTriggerBlock: block that's triggered when the cell is about to behave accordingly to its
didTriggerBlock: block that's triggered when the cell has already behaved accordingly to its
behaviorproperty. Here you should perform the main task for the cell action.
didChangeStateBlock: block that's triggered then the action reaches its active/unactive state.
DRCellSlideGestureRecognizer is available under the MIT license.