marmelroy / PeekPop

Peek and Pop with backwards-compatibility
MIT License
1.95k stars 123 forks source link

PeekPop - backwards-compatible peek and pop in Swift

Build Status Version Carthage compatible

PeekPop

Peek and Pop is a great new iOS feature introduced with iPhone 6S and 6S+ that allows you to easily preview content using 3D touch.

Sadly, almost 60% of iOS users are on older devices.

PeekPop is a Swift framework that brings backwards-compatibility to Peek and Pop.

Features

          |  Features

--------------------------|------------------------------------------------------------ :star2: | Uses Apple's beautiful peek and pop interaction for devices with 3D touch. :point_up_2: | Custom Pressure-sensitive tap recognition for older devices. :heartpulse: | Faithful recreation of the peek and pop animation on older devices. :iphone: | Almost identical API to Apple's. :eight: | Runs on all iOS8+ devices.

Missing features:

Usage

Import PeekPop at the top of the Swift file.

import PeekPop

Create a PeekPop object, register your view controller for handling the peek and specify the source view. You will also need to declare that your view controller will conform to the PeekPopPreviewingDelegate protocol.

class MyViewController: UIViewController, PeekPopPreviewingDelegate {

    var peekPop: PeekPop?

    override func viewDidLoad() {
        peekPop = PeekPop(viewController: self)
        peekPop?.registerForPreviewingWithDelegate(self, sourceView: collectionView)
    }

PeekPopPreviewingDelegate requires implementing two simple functions. You will need to tell it what view controller to present for peeking purposes with:

    func previewingContext(_ previewingContext: PreviewingContext, viewControllerForLocation location: CGPoint) -> UIViewController?

...and you will need to tell it how to commit the preview view controller at the end of the transition with:

    func previewingContext(_ previewingContext: PreviewingContext, commitViewController viewControllerToCommit: UIViewController)

How does it work?

In devices without 3D touch, PeekPop recognizes pressure on the screen by monitoring significant changes in UITouch's majorRadius value.

It assumes that by pressing harder on your iPhone, more of the surface area of your finger is in contact with the screen. This is true in the majority of cases.

Setting up with CocoaPods

source 'https://github.com/CocoaPods/Specs.git'
pod 'PeekPop', '~> 1.0'

Setting up with Carthage

Carthage is a decentralized dependency manager that automates the process of adding frameworks to your Cocoa application.

You can install Carthage with Homebrew using the following command:

$ brew update
$ brew install carthage

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

github "marmelroy/PeekPop"

Inspiration