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

Redd Angelo

Peek & Pop 在 iPhone 中是很實(shí)用的一個(gè)硬件相關(guān)特色功能,既可以提高操作效率,又有清晰的視覺表達(dá)。

Peek & Pop 是兩個(gè)過程的組合,Peek 代表輕按屏幕激活預(yù)覽窗口(會(huì)不會(huì)聯(lián)想到在電腦中鼠標(biāo)滑過鏈接時(shí)給出的提示,但這里視覺上更豐富了),Pop 代表繼續(xù)重(zhòng)按屏幕打開剛才的預(yù)覽窗口,如果只是輕按一下屏幕,預(yù)覽窗口隨著手指拿起就消失了。

實(shí)現(xiàn)這個(gè)功能最簡(jiǎn)單的方法就是通過 Storyboard 創(chuàng)建 Segue(手動(dòng)觸發(fā)模式的 Segue 除外),并在 Segue 上勾選 Peek & Pop。但是如果想定制展現(xiàn)過程,就要通過編碼的方式顯示了。

通過編碼實(shí)現(xiàn)這個(gè)功能的要點(diǎn)之一是提供一個(gè)用于預(yù)覽的視圖對(duì)象,而提供這個(gè)對(duì)象有 3 種不同的方法(一般教程中都未提到):

  1. 通過完整的程序編碼創(chuàng)建并初始化一個(gè)視圖控制器。
  2. 通過 XIB 設(shè)計(jì)視圖、自定義視圖控制器類文件,并通過 init(nibName:bundle:) 方法初始化視圖。
  3. 通過 Storyboard 設(shè)計(jì)好視圖,再通過 StoryboardinstantiateViewController 方法初始化這個(gè)視圖。

網(wǎng)上的其他教程基本都是描述的方法 1(包含開頭提到最簡(jiǎn)單的方法),方法 2、3 幾乎沒有提及。而方法 2、3 也是最容易出錯(cuò)的地方。

創(chuàng)建視圖的過程就不多說了,用哪個(gè)方法都可以,重點(diǎn)是初始化它。假設(shè)我們創(chuàng)建的視圖控制器類名稱是: PreviewingViewController。

  • 方法 1 直接用自定義的初始化方法就可以了(初始化方法甚至可以不寫),最典型就是: PreviewingViewController()。
  • 方法 2、3 如果還用 PreviewingViewController() ,接下來就等著報(bào)錯(cuò)和不停找問題了,筆者當(dāng)時(shí)就在這里耗了很多時(shí)間。因?yàn)榉椒?2、3 都是通過 UI 文件創(chuàng)建的視圖,它們的初始化方法只能使用特定的、也是標(biāo)準(zhǔn)的。具體說就是:
    • 使用 XIB 方式創(chuàng)建的視圖,要使用 init(nibName:bundle:) 方法初始化。
    • 通過 Storyboard 創(chuàng)建的視圖,要使用 instantiateViewController 方法初始化。

以上初始化方法掌握了,接下來就簡(jiǎn)單了,完成 Peek & Pop 一共三步。假設(shè)源視圖是 MainViewController,要預(yù)覽的是 PreviewingViewController

  • MainViewController 遵守 UIViewControllerPreviewingDelegate 協(xié)議,并在其 viewDidLoad() 方法中注冊(cè) Peek & Pop:
if traitCollection.forceTouchCapability == .available {
    registerForPreviewing(with: self, sourceView: tableView) // sourceView 使用需要觸發(fā)的 view 即可
}
  • 添加代理方法提供預(yù)覽的視圖: 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
    }
    // 按壓時(shí)聚焦 Cell
    // 按壓時(shí)要聚焦的區(qū)域都可以定制,提供你需要的就行。
    previewingContext.sourceRect = cell.frame

    // 根據(jù)上文討論的,提供相應(yīng)的初始化方法,這里以 storyboard 為例。
    let previewVC = self.storyboard?.instantiateViewController(
        withIdentifier: "xxx") as! PreviewingViewController
    // 把預(yù)覽需要的信息傳遞過去
    previewVC.xxx = self.xxx
    return previewVC
}   
  • 添加代理方法打開預(yù)覽視圖: previewingContext(_:commit:)
// Pop 操作
func previewingContext(_ previewingContext: UIViewControllerPreviewing,
                           commit viewControllerToCommit: UIViewController)
{
    // 這里使用的條件判斷,讓你在某些情況下不觸發(fā) Pop 操作。
    if xxx {
        show(viewControllerToCommit, sender: self)
        // 根據(jù)打開視圖的方式選擇 show 或 present
        // present(viewControllerToCommit, animated: true)
    }
}

題圖:Redd Angelo @unsplash

“你的喜愛就是我的動(dòng)力,歡迎各位打賞”

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成,瀏覽時(shí)請(qǐng)結(jié)合常識(shí)與多方信息審慎甄別。
平臺(tái)聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點(diǎn),簡(jiǎn)書系信息發(fā)布平臺(tái),僅提供信息存儲(chǔ)服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

友情鏈接更多精彩內(nèi)容