UISearchBar：使用 becomeFirstResponder 获得焦点并唤起键盘

Table of Contents

• 背景
• 问题描述
• 原因分析
• 解决方法
• 结语

背景

当我们使用 UISearchBar 时，常常会想当 searchBar 出现时，自动获得焦点并唤起键盘，这样就能省去用户手动点击搜索框准备输入这个步骤。
从 Apple 的官方文档中，我们知道：

• becomeFirstResponder

Notifies the receiver that it is about to become first responder in its window.

即对于继承自 UIResponder 的类，如：UISearchBar，使用 becomeFirstResponder 能够使其获得焦点，同时 CocoaTouch 还做了优化：获得焦点后当控件需要输入时，能够自动唤起键盘。

因此，我们只需要关注如何使 UISearchBar 获得焦点。但是某些情况下，使用 becomeFirstResponder 并不能实现我们的目标。下面我们将在实例中解决这个问题。

问题描述

在目前我正在开发的天气APP（源码请看这里）中，主界面的左侧有一个 tableView 用于显示不同的城市，其中有一个 tableViewCell，当点击它的时候，会出现另一个 viewController 供用户添加新的城市。

假设这个 viewController 为 viewController_A，这个类里包含了一个 tableView，和一个 UISearchBarController。

这样把 tableView 的 tableHeaderView 设置为 searchController.searchBar，就能把 searchBar 显示在 tableView 上。

现在的问题就是，当点击 tableViewCell，出现了包含 searchBar 的 viewController_A 时，并不会将焦点定位到 searchBar 上，当然也不会出现键盘。

我尝试了在 viewController_A 的 viewDidLoad() 里用：

searchController.active = true
searchController.searchBar.becomeFirstResponder()

第一行用于激活 searchController，第二行让 searchBar 获得焦点。

但是运行结果表明，只激活了 searchController，而没有把焦点定位到 searchBar 上。

原因分析

在官方文档里有如下描述：

A responder object only becomes the first responder if the current responder can resign first-responder status (canResignFirstResponder) and the new responder can become first responder.

一个 responder 想要成功获得焦点，必需满足，上一个 responder 能够放弃焦点，并且当前的 responder 能够获得焦点。

因此，问题就出在之前描述的那种情况下，使用：SearchController.searchBar.becomeFirstResponder() 的时候，searchBar 并没有能力获得焦点，因此焦点设置不成功。

但是为什么 searchBar 这时候没有能力获得焦点呢？

因为，在 viewDidLoad() 的时候，searchController 也刚刚初始化，必需得等到 searchController 初始化完毕，呈现出来的时候，才能为 searchBar 设置焦点。

解决方法

为了在 searchController 初始化之后，再进行 searchBar 焦点设置，我们可以为 viewController_A 声明 UISearchControllerDelegate，并在 didPresentSearchController 中添加焦点设置代码，如下：

extension ViewController_A : UISearchControllerDelegate {
    func didPresentSearchController(searchController: UISearchController) {
        searchController.searchBar.becomeFirstResponder()
    }
}

这样就能在出现 viewController_A 后，自动将焦点定位到 searchBar 并唤起键盘。

结语

这其实是 View 和 ViewController 的生命周期（cycle）的问题，在周期的各个阶段，会触发相应的事件，可以进行相应的设置。

之前在 viewDidLoad() 中同时设置 searchController.active 和 searchController.searchBar.becomeFirstResponder()，由于此时 searchBar 是不可用的，因此对它的设置无效。必需在 searchController 初始化完毕才能对 searchBar 进行设置。因此，后来，我们在 didPresentSearchController 中设置 searchBar，就能设置成功了。

附上我的Github：LinShiwei (Lin Shiwei) · GitHub