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

Peek & Pop 在 iPhone 中是很实用的一个硬件相关特点功能，既能够提升操做效率，又有清晰的视觉表达。

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

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

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

1. 经过完整的程序编码建立并初始化一个视图控制器。

2. 经过 XIB 设计视图、自定义视图控制器类文件，并经过 init(nibName:bundle:) 方法初始化视图。

3. 经过 Storyboard 设计好视图，再经过 Storyboard 的 instantiateViewController 方法初始化这个视图。

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

建立视图的过程就很少说了，用哪一个方法均可以，重点是初始化它。假设咱们建立的视图控制器类名称是: PreviewingViewController。

• 方法 1 直接用自定义的初始化方法就能够了（初始化方法甚至能够不写），最典型就是: PreviewingViewController()。

• 方法 二、3 若是还用 PreviewingViewController() ，接下来就等着报错和不停找问题了，笔者当时就在这里耗了不少时间。由于方法 二、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

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