Latest 1.1
Homepage https://github.com/enricenrich/EECellSwipeGestureRecognizer
License MIT
Platforms ios 8.0, requires ARC
Authors

CocoaPods
Carthage compatible
Travis
[CocoaPods]()

A clean and easy way to implement swipe actions to UITableViewCell. You’ll simply have to add a gesture recognizer to the cells that you want. That’s all; you don’t have to subclass anything.

This library is writen in Swift based on DRCellSlideGestureRecognizer by David Román.

Features

  • UITableView/UITableViewCell class agnostic.
  • Setup multiple actions for multiple cell fractions.
  • Fully customizable.
  • Block-driven.

Installation

Embedded frameworks require a minimum deployment target of iOS 8, use Xcode 8 and Swift 3.

CocoaPods

CocoaPods is a dependency manager for Objective-C and Swift projects. It has thousands of libraries and can help you scale your projects elegantly. You can install it with the following command:

gem install cocoapods

Podfile

To integrate EECellSwipeGestureRecognizer into your Xcode project using CocoaPods, specify it in your Podfile:

source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '8.0'

target 'TargetName' do
pod 'EECellSwipeGestureRecognizer', '~> 1.0'
end

Then, run the following command:

pod install

Carthage

Carthage is a decentralized dependency manager that builds your dependencies and provides you with binary frameworks.

You can install Carthage with Homebrew using the following command:

brew update
brew install carthage

To integrate EECellSwipeGestureRecognizer into your Xcode project using Carthage, specify it in your Cartfile:

github "enricenrich/EECellSwipeGestureRecognizer" ~> 1.0

Run carthage to build the framework and drag the built EECellSwipeGestureRecognizer.framework into your Xcode project.

Manual

Drag and copy all files in the Source folder into your project.

At a glance

Setting up actions

First instatiate EECellSwipeGestureRecognizer to later add the actions:

let gestureRecognizer: EECellGestureRecognizer = EECellGestureRecognizer()

Then, simply instantiate EECellSwipeAction like this:

let action: EECellSwipeAction = EECellSwipeAction(fraction: 0.25)
action.behavior = .Push
action.icon = UIImage(named: "yourImage")

Note: fraction determines the part of the cell to where the action will become active and ready to be triggered. It can go from 0 to 1 (swipe to the right), and from 0 to -1 (swipe to the left).

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 or in the subclass if you created it.

Customizing actions

There are multiple EECellSwipeAction 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:
  • EECellSwipeActionBehavior.Pull: the cell returns to its original position.
  • EECellSlideActionBehavior.Push: 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 icon when the action is active.
  • inactiveColor: the color of icon when the action is inactive.
  • activeBackgroundColor: the background color when the action is active.
  • inactiveBackgroundColor: the background color when the action is inactive.
  • willTrigger: block that’s triggered when the cell is about to behave accordingly to its behavior property.
  • didTrigger: block that’s triggered when the cell has already behaved accordingly to its behavior property. Here you should perform the main task for the cell action.
  • didChangeState: block that’s triggered then the action reaches its active/unactive state.

License

EECellSwipeGestureRecognizer is available under the MIT license.

Contact

You can find me on Twitter (@enricenrich) or on my website.

Latest podspec

{
    "name": "EECellSwipeGestureRecognizer",
    "version": "1.1",
    "license": "MIT",
    "summary": "Clean and easy way to implement swipe actions to UITableViewCell",
    "homepage": "https://github.com/enricenrich/EECellSwipeGestureRecognizer",
    "social_media_url": "https://twitter.com/enricenrich",
    "authors": {
        "Enric Enrich": "[email protected]"
    },
    "source": {
        "git": "https://github.com/enricenrich/EECellSwipeGestureRecognizer.git",
        "tag": "1.1"
    },
    "platforms": {
        "ios": "8.0"
    },
    "source_files": "Source/EECellSwipeGestureRecognizer/*.swift",
    "requires_arc": true
}

Pin It on Pinterest

Share This