Skip to content

TCSTableViewRowActionFactory allows you to setup the swipe actions for cells in a table view using UIView and some other convenient methods

License

Notifications You must be signed in to change notification settings

tinkoff-mobile-tech/tcscustomrowactionfactory

Repository files navigation

TCSCustomRowActionFactory

Version License Platform

TCSCustomRowActionFactory allows you to setup the swipe actions for cells in a table view in any way using UIView and other convenient methods (see the article explaining this on Habrahabr)

picture

Usage and examples

TCSCustomRowActionFactory is primarily designed to simplify the standard UITableViewRowAction configuration (due to the many restrictions it imposes), also supporting the new ContextualAction (iOS 11 and above). All you need to do to implement TCSCustomRowActionFactory, create a TCSCustomRowActionFactory instance in the table delegate method, configure it with our custom view and return the required object (.rowAction () or .contextualAction(for: indexPath) depending on the table delegate method)

func tableView(_ tableView: UITableView, editActionsForRowAt indexPath: IndexPath) -> [UITableViewRowAction]? {
    guard let cell = tableView.cellForRow(at: indexPath) else { return nil }
    
    var rowActions: [UITableViewRowAction] = []
    
    let rowActionFactory = TCSCustomRowActionFactory { indexPath in
        tableView.setEditing(false, animated: true)
    }
    let rowActionView = <...> // create row action view
    rowActionView.backgroundColor = .green
    rowActionFactory.setupForCell(with: rowActionView)
    
    if let rowAction = rowActionFactory.rowAction() {
        rowActions.append(rowAction)
    }
    
    return rowActions
}

Methods

There are some methods to setup TCSCustomRowActionFactory:

func setupForCell(with view: UIView)
func setupForCell(withImage image: UIImage, size: CGSize, backgroundColor: UIColor = .white) 
func setupForCell(withImage image: UIImage, size: CGSize, backgroundColor: UIColor = .white, contentInsets: UIEdgeInsets = .zero)
func setupForCell(withImage image: UIImage, size: CGSize, backgroundColor: UIColor = .white, contentInsets: UIEdgeInsets = .zero, isScaleProportionally: Bool = true)
func setupForCell(withTitle title: String, image: UIImage, size: CGSize, backgroundColor: UIColor, titleAttributes: [NSAttributedStringKey : Any]? = nil, contentInsets: UIEdgeInsets? = nil)

Example

To run the example project, clone the repo, and run pod install from the Example directory first.

Requirements

Installation

TCSCustomRowActionFactory is available through CocoaPods. To install it, simply add the following line to your Podfile:

pod 'TCSCustomRowActionFactory'

Contribution

Sure :) please send a pull-request or raise an issue. It is always good to know how to make things better, yay!

Author

Alexander Trushin, a.trushin@tinkoff.ru

License

TCSCustomRowActionFactory is available under the Apache License, Version 2.0. See the LICENSE file for more info.

About

TCSTableViewRowActionFactory allows you to setup the swipe actions for cells in a table view using UIView and some other convenient methods

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published