转载

iOS9：预览特定的 UITableViewCell 视图

作者：Natasha，原文链接，原文日期：2016-02-13

译者： Prayer ；校对：小锅；定稿： shanks

在过去的几天中，我一直忙于开发 try! Swift 会议的官方 App （只剩两周半的时间了，我的天哪:scream:）！项目中一大亮点就是，我要实现在 app 中使用 3D Touch 来支持演讲者和展示的内容的弹窗预览（Peek & Pop）。幸运的是， @allonsykraken 的博文 Peek & Pop Spirit Guide 让这个任务完成起来比较简单，为 table view 主视图添加 3D Touch 仅仅花费了几分钟时间就搞定了。

然而，在 Q&A 模块中遇到了一些问题。我希望在 cell 中特定的视图上—— 演讲者的图片 ——来使用 peek & pop，而不是像其他模块那样，在整个 cell 上使用。

因为这个花费了很长时间才解决，所以我想把它记录下来。（在阅读本文之前，请先阅读 Peek & Pop Spirit Guide ）

问题所在

为了能够使用 Peak & Pop 功能，我们需要遵循 UIViewControllerPreviewingDelegate 协议——这个协议会告知我们用户使用 3D Touch 功能点击了哪儿，并且在这里返回相应的 ViewController 实例。

因为我的这些图片存在于 cell 中，需要能够区别出用户使用 3D Touch 点击了哪个演讲者的图片，这里我让 cell 遵循 UIViewControllerPreviewingDelegate：

// QASessionTableViewCell
// QASessionTableViewCell here: https://github.com/NatashaTheRobot/trySwiftApp/blob/master/trySwift/QASessionTableViewCell.swift
 
protocol QASessionSpeakerPopDelegate: class {
    // view controller 将遵循该协议，来正确的设置导航视图
    func onCommitViewController(viewController: UIViewController)
}
 
extension QASessionTableViewCell: UIViewControllerPreviewingDelegate {
    
    // UIViewControllerPreviewingDelegate conformance
    func previewingContext(previewingContext: UIViewControllerPreviewing, viewControllerForLocation location: CGPoint) -> UIViewController? {
        
        let viewsTo3DTouch = [speaker1ImageView, speaker2ImageView, speaker3ImageView]
        
        for (index, view) in viewsTo3DTouch.enumerate() where touchedView(view, location: location) {
            if let speaker = qaSession?.speakers[index] {
                // 返回显示 peek & pop 功能所需要的控制器
                return viewControllerForSpeaker(speaker)
            }
        }
        
        return nil
    }
    
    func previewingContext(previewingContext: UIViewControllerPreviewing, commitViewController viewControllerToCommit: UIViewController)
    {
        // 如果用户选择 pop 出视图，我们需要跳转到相应的视图控制器
        // 在设置 cell 的时候，delegate 将会被赋值
        delegate?.onCommitViewController(viewControllerToCommit)
    }
    
    // helper methods
    private func touchedView(view: UIView, location: CGPoint) -> Bool {
        let locationInView = view.convertPoint(location, fromView: contentView)
        return CGRectContainsPoint(view.bounds, locationInView)
    }
    
    private func viewControllerForSpeaker(speaker: Speaker) -> UIViewController {
        let speakerDetailVC = SpeakerDetailViewController()
        speakerDetailVC.speaker = speaker
        return speakerDetailVC
    }
}
 
// QASessionsTableViewController
// 全部的代码地址: https://github.com/NatashaTheRobot/trySwiftApp/blob/master/trySwift/QASessionsTableViewController.swift
extension QASessionsTableViewController: QASessionSpeakerPopDelegate {
 
    // 当视图 pop 出来的时候，view controller 负责处理跳转
    func onCommitViewController(viewController: UIViewController) {
        navigationController?.pushViewController(viewController, animated: true)
    }
}

问题在于，想要使用 Peek & Pop 功能，我们需要使用 registerForPreviewingWithDelegate 来注册视图和设置代理，但是 registerForPreviewingWithDelegate 是 UIViewController 中的方法，所以我们不能够在 cell 的代码中注册视图！

解决办法

问题的关键在于，我们现在需要 view controller 中 注册每一个 cell （而不是像 Schedule 或 Speaker 模块那样直接注册整个 table view）

// QASessionsTableViewController
 
class QASessionsTableViewController: UITableViewController {
    // 代码有删减
    // 全部的代码地址: https://github.com/NatashaTheRobot/trySwiftApp/blob/master/trySwift/QASessionsTableViewController.swift
    
    override func tableView(tableView: UITableView, cellForRowAtIndexPath indexPath: NSIndexPath) -> UITableViewCell {
        let cell = tableView.dequeueReusableCellWithIdentifier(String(QASessionTableViewCell), forIndexPath: indexPath) as! QASessionTableViewCell
        
        let qaSession = dataSource.qaSessions[indexPath.section]
        cell.configure(withQASession: qaSession, delegate: self)
        
        // 这是见证奇迹的时刻
        // 我们需要注册每一个 cell
        if traitCollection.forceTouchCapability == .Available {
            registerForPreviewingWithDelegate(cell, sourceView: cell.contentView)
        }
        
        return cell
    }
 
}

更新

@davedelong 指出在 cell 中创建添加到 navigation 中的控制器看起来不是一个明智的选择。我完全同意他的观点！但是写代码的时候在 deadline 的压迫下，我没有想到更好的实现方式。幸运的是， @davedelong 提出了一种更好的解决办法，通过这种方式，可以让这些代码保留在应有的 view controller 中！

下面的代码经过了一些重构，希望你能够 get 到其中的精髓！

// QASessionsTableViewController
 
class QASessionsTableViewController: UITableViewController {
 
    var dataSource: QASessionDataSourceProtocol!
    
    override func viewDidLoad() {
        super.viewDidLoad()
        // other setup here
 
        // 只需要为 force touch 注册整个 table view
        // 不需要分别注册单个的 cell
        if traitCollection.forceTouchCapability == .Available {
            registerForPreviewingWithDelegate(self, sourceView: tableView)
        }
    }
 
    // 代码有删减
}
 
// MARK: Force Touch on Speaker Images
extension QASessionsTableViewController: UIViewControllerPreviewingDelegate {
    
    func previewingContext(previewingContext: UIViewControllerPreviewing, viewControllerForLocation location: CGPoint) -> UIViewController? {
        if let indexPath = tableView.indexPathForRowAtPoint(location) {
 
            let cell = tableView.cellForRowAtIndexPath(indexPath) as! QASessionTableViewCell
            
            let viewsTo3DTouch = [cell.speaker1ImageView, cell.speaker2ImageView, cell.speaker3ImageView]
            for (index, view) in viewsTo3DTouch.enumerate() where touchedView(view, location: location) {
                
                // 只将图片清晰地显示，其他内容将会变得模糊
                // 需要将 image view 的坐标转化为在 table view 坐标系中的坐标 
                // 如果你有更好的坐标转换方式，请告诉我！
                let viewRectInTableView = tableView.convertRect(view.frame, fromCoordinateSpace: view.superview!)
                previewingContext.sourceRect = viewRectInTableView
                
                // 设置需要显示的 view controller
                let qaSession = dataSource.qaSessions[indexPath.section]
                let speaker = qaSession.speakers[index]
                return viewControllerForSpeaker(speaker)
            }
        }
        return nil
    }
    
    func previewingContext(previewingContext: UIViewControllerPreviewing, commitViewController viewControllerToCommit: UIViewController) {
        navigationController?.pushViewController(viewControllerToCommit, animated: true)
    }
    
    private func touchedView(view: UIView, location: CGPoint) -> Bool {
        let locationInView = view.convertPoint(location, fromView: tableView)
        return CGRectContainsPoint(view.bounds, locationInView)
    }
    
    private func viewControllerForSpeaker(speaker: Speaker) -> UIViewController {
        let speakerDetailVC = SpeakerDetailViewController()
        speakerDetailVC.speaker = speaker
        return speakerDetailVC
    }
 
}