iOS代理方法深度解析

代理方法概述

• 方法签名：func tableView(_ tableView: UITableView, didSelectRowAt indexPath: IndexPath)
• 所属协议：UITableViewDelegate（可选方法）
• 功能简介：当用户在表视图中选择某一行后回调，用于响应选择事件（如导航、更新界面、触发业务逻辑）。在单选模式下会伴随对之前选中行的自动取消选择（并触发 didDeselectRowAt）。

技术详解

• 调用时机：

  • 在用户点按某一可选中行并完成一次触摸交互后调用。
  • 典型事件顺序（简化）：shouldHighlightRowAt → 高亮 → willSelectRowAt → 选择发生 → （必要时）didDeselectRowAt → didSelectRowAt → 取消高亮。
  • 受下列条件影响：
    • tableView.allowsSelection == false：不会调用。
    • 若实现 tableView(_:willSelectRowAt:) 并返回 nil：选择被阻止，不会调用。
    • 多选模式（allowsMultipleSelection == true）：不会自动取消之前选择，可连续触发 didSelectRowAt。
    • 编辑模式（isEditing == true）：仅在 allowsSelectionDuringEditing == true 时会触发。
    • VoiceOver、键盘等辅助方式选择仍会触发该回调。
  • 注意：调用 selectRow(at:animated:scrollPosition:) 进行编程式选择不会自动触发该代理方法；类似地，deselectRow(at:animated:) 也不会自动触发 didDeselectRowAt。

• 执行流程：

  • 方法在主线程上执行。
  • indexPath 对应当前数据源状态下的行位置；在单选模式下若已有选中的行，将先触发该行的 didDeselectRowAt，再触发新选中的行的 didSelectRowAt。
  • 常见后续操作包括：导航到详情页、更新所选状态、触发网络请求、记录埋点等。
  • 视觉处理：通常在回调中调用 deselectRow(at:animated:) 以恢复默认的非高亮状态，符合系统交互习惯。

• 参数解析：

  • tableView: UITableView
    • 触发事件的表视图实例。
    • 可根据该实例的配置（如 allowsMultipleSelection、isEditing）决定处理逻辑。
  • indexPath: IndexPath
    • 选中行的位置，由 section 和 row 组成。
    • 应通过该位置索引你的数据模型，而非直接依赖 cell 内容；必要时使用稳定标识（ID）而非持久化 IndexPath，避免数据变更导致的错位。
    • 若需要访问 cell，可通过 tableView.cellForRow(at:) 获取；但该方法仅对当前可见行返回非空。

• 返回值说明：

  • 无返回值。
  • 是否允许选择应在 tableView(_:willSelectRowAt:) 或 tableView(_:shouldHighlightRowAt:) 中控制；didSelectRowAt 仅用于“选择已发生”后的响应。

应用示例

import UIKit

// 假设有一个基于稳定标识的数据模型
struct Item: Hashable {
    let id: UUID
    let title: String
}

final class ItemsViewController: UIViewController {
    @IBOutlet private weak var tableView: UITableView!

    // 数据源：按 section 分组的二维数组（或使用 Diffable Data Source）
    private var sections: [[Item]] = []

    // 防止重复导航的状态标记
    private var isNavigating = false

    override func viewDidLoad() {
        super.viewDidLoad()

        tableView.delegate = self
        tableView.dataSource = self
        tableView.allowsSelection = true
        tableView.allowsMultipleSelection = false // 单选示例
    }

    // 根据 IndexPath 安全地获取模型
    private func item(at indexPath: IndexPath) -> Item? {
        guard sections.indices.contains(indexPath.section),
              sections[indexPath.section].indices.contains(indexPath.row) else { return nil }
        return sections[indexPath.section][indexPath.row]
    }

    // 典型的导航处理
    private func showDetail(for item: Item) {
        // 模拟耗时任务或导航
        // 真实项目可 push 到详情控制器并传入 item.id
        let detailVC = DetailViewController(itemID: item.id)
        navigationController?.pushViewController(detailVC, animated: true)
    }
}

// MARK: - UITableViewDataSource
extension ItemsViewController: UITableViewDataSource {
    func numberOfSections(in tableView: UITableView) -> Int { sections.count }
    func tableView(_ tableView: UITableView, numberOfRowsInSection section: Int) -> Int { sections[section].count }

    func tableView(_ tableView: UITableView,
                   cellForRowAt indexPath: IndexPath) -> UITableViewCell {
        let cell = tableView.dequeueReusableCell(withIdentifier: "Cell", for: indexPath)
        if let item = item(at: indexPath) {
            cell.textLabel?.text = item.title
            cell.selectionStyle = .default // 即便为 .none，didSelectRowAt 仍会被调用（若允许选择）
        }
        return cell
    }
}

// MARK: - UITableViewDelegate
extension ItemsViewController: UITableViewDelegate {

    // 可选：禁止某些行被选中（例如禁用奇数行）
    func tableView(_ tableView: UITableView, willSelectRowAt indexPath: IndexPath) -> IndexPath? {
        let isSelectable = indexPath.row % 2 == 0
        return isSelectable ? indexPath : nil
    }

    // 核心：处理选择事件
    func tableView(_ tableView: UITableView, didSelectRowAt indexPath: IndexPath) {
        // 按系统规范，尽快取消高亮以获得一致的交互体验
        tableView.deselectRow(at: indexPath, animated: true)

        // 索引模型；避免直接依赖 cell 内容
        guard let item = item(at: indexPath) else { return }

        // 防抖：避免快速连续点按导致重复导航或业务逻辑重复触发
        guard !isNavigating else { return }
        isNavigating = true

        // 在主线程进行导航；耗时任务放到后台
        DispatchQueue.main.async { [weak self] in
            self?.showDetail(for: item)
            self?.isNavigating = false
        }
    }

    // 可选：多选模式下的取消选择处理（用户在单选模式切换到另一行时也会触发）
    func tableView(_ tableView: UITableView, didDeselectRowAt indexPath: IndexPath) {
        // 更新状态或统计
    }

    // 可选：细化高亮行为（不高亮但允许选择时，可返回 false）
    func tableView(_ tableView: UITableView, shouldHighlightRowAt indexPath: IndexPath) -> Bool {
        return true
    }
}

// 示例详情控制器
final class DetailViewController: UIViewController {
    private let itemID: UUID
    init(itemID: UUID) {
        self.itemID = itemID
        super.init(nibName: nil, bundle: nil)
    }
    required init?(coder: NSCoder) { fatalError("init(coder:) has not been implemented") }
}

注意事项

• 实现要求：

  • 方法在主线程回调；UI 更新与导航需在主线程执行。
  • 始终通过 indexPath 查询数据模型，避免直接读取 cell 内容以防数据/视图不同步。
  • 若使用 UITableViewController，默认 clearsSelectionOnViewWillAppear == true 会在界面返回时自动取消选中；如需保留选中状态，将其置为 false 并自行管理。

• 常见问题：

  • 编程式选择不触发回调：selectRow(at:animated:scrollPosition:) 不会调用 didSelectRowAt。如需统一逻辑，可在选择后手动调用处理函数或统一封装。
  • 选择被意外阻止：检查 allowsSelection、isEditing 与 allowsSelectionDuringEditing，以及 willSelectRowAt 是否返回了 nil。
  • 索引越界或数据错位：在异步刷新或使用差量更新时，indexPath 在回调后可能变得无效。应使用稳定 ID（如模型主键）驱动导航与业务。
  • 重复触发：快速连续点按会多次调用。加入防抖或在处理期间禁用交互。

• 最佳实践：

  • 在 didSelectRowAt 中调用 tableView.deselectRow(at:animated:)，使交互与系统一致。
  • 保持回调内逻辑轻量，将耗时操作（网络请求、复杂计算）转移到后台队列；仅在主线程回写 UI。
  • 使用 willSelectRowAt/shouldHighlightRowAt 定制选择策略：前者控制“能否选中”，后者控制“是否高亮”。
  • 在单选切换时，考虑 didDeselectRowAt 做状态同步（如复选 UI 或统计）。
  • 若使用 Diffable Data Source，导航应基于项的标识而非 IndexPath，以应对快照更新带来的行位置变化。