How do I add swipe actions to a UITableView cell with custom buttons?

Use SWTableViewCell by setting it in tableView:cellForRowAtIndexPath:, then add utility buttons with titles or icons using the NSMutableArray category methods. Implement delegate methods like didTriggerLeftUtilityButtonWithIndex to handle taps.

SWTableViewCell vs iOS native swipe actions: which should I use?

For iOS 11+, prefer native UITableViewSwipeActionsConfiguration for better integration and maintenance. SWTableViewCell is better for older iOS support or when needing more customization like simultaneous left and right buttons.

Can I use SWTableViewCell with Swift?

Yes, but since it's Objective-C, you'll need a bridging header to import it, and delegate methods require @objc annotations. It works but adds extra steps compared to Swift-native libraries.

How to customize button colors and icons in SWTableViewCell?

Use sw_addUtilityButtonWithColor:title: or sw_addUtilityButtonWithColor:icon: methods to set RGB colors and UIImage icons, allowing full control over button appearance as shown in the code examples.

Is SWTableViewCell still maintained for iOS 14?

No, the last release was in 2014, so it's not actively maintained and may have compatibility issues with newer iOS versions, Xcode, and device screens.

How to handle deletion with animation in SWTableViewCell?

In the delegate method didTriggerRightUtilityButtonWithIndex, remove the data source item and call tableView.deleteRowsAtIndexPaths:withRowAnimation: to animate deletion, similar to the example project snippet.

Open-Awesome

SWTableViewCell

MITObjective-C

A UITableViewCell subclass that implements swipeable content with utility buttons, similar to iOS 7 Mail app.

GitHub

7.1k stars1.3k forks0 contributors

What is SWTableViewCell?

SWTableViewCell is an open-source UITableViewCell subclass for iOS that implements swipeable table rows with exposed utility buttons. It solves the problem of adding interactive actions to table cells without cluttering the interface, providing behavior similar to the iOS Mail app where users can swipe to reveal delete, archive, or custom buttons.

Target Audience

iOS developers building table-based interfaces who need to add swipe actions to table cells, particularly those targeting iOS 6.1+ and wanting native-like interaction patterns.

Value Proposition

Developers choose SWTableViewCell because it provides a production-ready, customizable implementation of swipeable table cells that matches Apple's design patterns, saving development time compared to building this functionality from scratch.

Overview

An easy-to-use UITableViewCell subclass that implements a swippable content view which exposes utility buttons (similar to iOS 7 Mail Application)

Use Cases

Best For

Adding swipe actions to table rows in iOS apps
Implementing delete/edit functionality in table views
Creating iOS interfaces with native-style swipe gestures
Building custom table cells with multiple action buttons
Replicating iOS Mail app's swipe behavior in third-party apps
Adding left and right swipe actions to UITableView cells

Not Ideal For

Apps targeting iOS 11+ that want to use Apple's native UITableViewSwipeActionsConfiguration for better system integration and future-proofing
SwiftUI-exclusive projects, as it's built for UIKit and doesn't integrate with SwiftUI's declarative syntax
Teams requiring out-of-the-box accessibility features or support for latest iOS design guidelines like dark mode and dynamic type

Pros & Cons

Pros

Dynamic Button Scaling

Buttons automatically resize as more are added, ensuring all utility buttons fit within the cell width without manual layout adjustments, as demonstrated in the GIF examples.

Smart Selection Handling

Prevents accidental row selection when utility buttons are visible by sliding the cell back instead, mimicking iOS Mail app behavior to improve user experience.

Custom Cell Compatibility

Works with both standard UITableViewCells and custom cells designed in Interface Builder, with clear instructions for nib registration and subclassing.

Easy CocoaPods Integration

Can be quickly added via CocoaPods with 'pod SWTableViewCell', simplifying dependency management and setup for iOS projects.

Cons

Outdated and Unmaintained

Last updated in 2014 with version 0.3.7, it lacks support for newer iOS features like safe areas, dark mode, and native swipe APIs, making it a legacy choice.

Manual Configuration Required

Requires manual tweaks like setting separator insets for proper display on iOS 7+, indicating it doesn't handle all edge cases automatically.

Objective-C Legacy Code

Written in Objective-C, it may require bridging headers in Swift projects and doesn't leverage modern Swift paradigms, adding complexity for Swift-focused teams.

Frequently Asked Questions

Related Projects

MGSwipeTableCell

An easy to use UITableViewCell subclass that allows to display swippable buttons with a variety of transitions.

Stars6,928

Forks1,064

Last commit3 years ago

SwipeCellKit

Swipeable UITableViewCell/UICollectionViewCell based on the stock Mail.app, implemented in Swift.

Stars6,289

Forks812

Last commit1 year ago

MCSwipeTableViewCell

:point_up_2: Convenient UITableViewCell subclass that implements a swippable content to trigger actions (similar to the Mailbox app).

Stars2,939

Forks408

Last commit7 years ago

AMWaveTransition

Custom transition between viewcontrollers holding tableviews

Stars2,359

Forks291

Last commit5 years ago

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub