如何在 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

歡迎訪問 個人我的網站 ，閱讀更多文章。