Latest 3.1.1
Homepage https://github.com/lionheart/TableViewPopoverPresenting
License Apache 2.0
Platforms ios 8.0
Frameworks UIKit
Authors

TableViewPopoverPresenting
TableViewPopoverPresenting

CI Status
Version
License
Platform

TableViewPopoverPresenting is a simple, drop-in protocol that gives your table views the power to display presented view controllers in popovers in reaction to a cell tap. It overrides the standard table view tap handler only for the cells which you define it for, and everything else falls back to your existing tableView(_:didSelectRowAt:) implementation.

TableViewPopoverPresenting

Why Does This Exist

In the good ole’ days, in order to present popovers over your table view cells, you had to do a few things:

  1. Instantiate a UITapGestureRecognizer.
  2. Add it to your UITableView.
  3. Make your UIViewController conform to UIGestureRecognizerDelegate.
  4. Create a method to handle the tap.
  5. Make sure the tap gesture recognizer doesn’t override the standard UITableView touch handlers for tableView(_:didSelectRowAt:).
  6. Find the point where the user tapped.
  7. Retrieve which index path the user tapped corresponding to that point.
  8. Make sure that you actually want to show a view controller at that index path.
  9. Decide on which view controller to show.
  10. And finally, present the view controller exactly where the user tapped in a popover.

Each one of these items requires going through StackOverflow posts with a fine-toothed comb to make sure you’re doing everything the "right" way. Obviously, that’s lame. You shouldn’t need to do all of this work for something which should be simple. And that’s where TableViewPopoverPresenting comes in.

Installation

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

pod "TableViewPopoverPresenting"

Usage

  1. Install TableViewPopoverPresenting through Cocoapods by adding the following line to your Podfile.

    pod "TableViewPopoverPresenting"
  2. Import TableViewPopoverPresenting in the file with your table view controller.

    import TableViewPopoverPresenting

Now, for each view controller, do the following:

  1. Call initializeTableViewPopover in viewDidLoad:

    func viewDidLoad() {
       super.viewDidLoad()
    
       # ...
    
       initializeTableViewPopover()
    
       # ...
    }
  2. Implement viewController(forPopoverAt:) to define which view controllers to show at which index paths. E.g.:

    func viewController(forPopoverAt: IndexPath) -> UIViewController? {
       if indexPath.row == 0 {
           let actionSheet = UIAlertController(title: "Important Question", message: "What's your favorite color?", preferredStyle: .ActionSheet)
           actionSheet.addAction(UIAlertAction(title: "Red", style: .Default) { _ in })
           actionSheet.addAction(UIAlertAction(title: "Green", style: .Default) { _ in })
           actionSheet.addAction(UIAlertAction(title: "Blue", style: .Default) { _ in })
           return actionSheet
       } else {
           return nil
       }
    }

And…that’s it. You’re done. A nice action sheet will appear when a tap is detected on the first row of any section. Easy, right?

Requirements

None.

Author

Dan Loewenherz, [email protected]

License

TableViewPopoverPresenting is available under the Apache 2.0 license. See the LICENSE file for more info.

Donate

Donations help support our open source efforts.

Donate Now

Latest podspec

{
    "name": "TableViewPopoverPresenting",
    "version": "3.1.1",
    "summary": "Display popovers on taps over your table views cells. It was hard. Now it's easy.",
    "description": "TableViewPopoverPresenting is a simple, drop-in protocol that gives yourn  table views the power to display presented view controllers in popoversn  in reaction to a cell tap. It overrides the standard table view tap handlern  only for the cells which you define it for, and everything else falls backn  to your existing `didSelectRowAtIndexPath` implementation.",
    "homepage": "https://github.com/lionheart/TableViewPopoverPresenting",
    "license": {
        "type": "Apache 2.0",
        "file": "LICENSE"
    },
    "authors": {
        "Dan Loewenherz": "[email protected]"
    },
    "source": {
        "git": "https://github.com/lionheart/TableViewPopoverPresenting.git",
        "tag": "3.1.1"
    },
    "social_media_url": "https://twitter.com/dwlz",
    "platforms": {
        "ios": "8.0"
    },
    "source_files": "TableViewPopoverPresenting/Protocols/**/*",
    "frameworks": "UIKit"
}

Pin It on Pinterest

Share This