如何在 Table View 中添加 3D Touch Peek & Pop 功能

Peek & Pop 在 iPhone 中是很实用的一个硬件相关特色功能，既可以提高操作效率，又有清晰的视觉表达。

Peek & Pop 是两个过程的组合，Peek 代表轻按屏幕激活预览窗口（会不会联想到在电脑中鼠标滑过链接时给出的提示，但这里视觉上更丰富了），Pop 代表继续重(zhòng)按屏幕打开刚才的预览窗口，如果只是轻按一下屏幕，预览窗口随着手指拿起就消失了。

实现这个功能最简单的方法就是通过 Storyboard 创建 Segue(手动触发模式的 Segue 除外)，并在 Segue 上勾选 Peek & Pop。但是如果想定制展现过程，就要通过编码的方式显示了。

通过编码实现这个功能的要点之一是提供一个用于预览的视图对象，而提供这个对象有 3 种不同的方法（一般教程中都未提到）：

通过完整的程序编码创建并初始化一个视图控制器。
通过 XIB 设计视图、自定义视图控制器类文件，并通过 init(nibName:bundle:) 方法初始化视图。
通过 Storyboard 设计好视图，再通过 Storyboard 的 instantiateViewController 方法初始化这个视图。

网上的其他教程基本都是描述的方法 1（包含开头提到最简单的方法），方法 2、3 几乎没有提及。而方法 2、3 也是最容易出错的地方。

创建视图的过程就不多说了，用哪个方法都可以，重点是初始化它。假设我们创建的视图控制器类名称是: PreviewingViewController。

方法 1 直接用自定义的初始化方法就可以了（初始化方法甚至可以不写），最典型就是: PreviewingViewController()。
方法 2、3 如果还用 PreviewingViewController() ，接下来就等着报错和不停找问题了，笔者当时就在这里耗了很多时间。因为方法 2、3 都是通过 UI 文件创建的视图，它们的初始化方法只能使用特定的、也是标准的。具体说就是：
- 使用 XIB 方式创建的视图，要使用 init(nibName:bundle:) 方法初始化。
- 通过 Storyboard 创建的视图，要使用 instantiateViewController 方法初始化。

以上初始化方法掌握了，接下来就简单了，完成 Peek & Pop 一共三步。假设源视图是 MainViewController，要预览的是 PreviewingViewController：

让 MainViewController 遵守 UIViewControllerPreviewingDelegate 协议，并在其 viewDidLoad() 方法中注册 Peek & Pop:

if traitCollection.forceTouchCapability == .available {
    registerForPreviewing(with: self, sourceView: tableView) // sourceView 使用需要触发的 view 即可
}

添加代理方法提供预览的视图: previewingContext(_:viewControllerForLocation:):

// Peek 操作
func previewingContext(_ previewingContext: UIViewControllerPreviewing,
                       viewControllerForLocation location: CGPoint) -> UIViewController?
{
    // 获取被按压的 Cell
    guard
    let indexPath = tableView.indexPathForRow(at: location),
    let cell = tableView.cellForRow(at: indexPath)
    else {
        return nil
    }
    // 按压时聚焦 Cell
    // 按压时要聚焦的区域都可以定制，提供你需要的就行。
    previewingContext.sourceRect = cell.frame

    // 根据上文讨论的，提供相应的初始化方法，这里以 storyboard 为例。
    let previewVC = self.storyboard?.instantiateViewController(
        withIdentifier: "xxx") as! PreviewingViewController
    // 把预览需要的信息传递过去
    previewVC.xxx = self.xxx
    return previewVC
}

添加代理方法打开预览视图: previewingContext(_:commit:)：

// Pop 操作
func previewingContext(_ previewingContext: UIViewControllerPreviewing,
                           commit viewControllerToCommit: UIViewController)
{
    // 这里使用的条件判断，让你在某些情况下不触发 Pop 操作。
    if xxx {
        show(viewControllerToCommit, sender: self)
        // 根据打开视图的方式选择 show 或 present
        // present(viewControllerToCommit, animated: true)
    }
}

题图：Redd Angelo @unsplash

欢迎访问我的个人网站，阅读更多文章。