UITextField、UITextView、UISearchBar 這三類物件都會彈出虛擬鍵盤,但系統並沒有提供「自動收起」的機制,得自己實作。網路上流傳的做法很多,各有適用場景,也各有陷阱。本文把六種方式逐一檢視,並指出各自的限制。
透過 UITextFieldDelegate 攔截 return 鍵:
- (BOOL)textFieldShouldReturn:(UITextField *)textField {
if ((textField == self.birdNameInput) || (textField == self.locationInput)) {
[textField resignFirstResponder];
}
return YES;
}
鍵盤上的 return 鍵被按下時就會收起鍵盤。缺點很明顯:手指不像滑鼠那麼精準,要瞄準鍵盤右下角那顆小按鈕並不容易。
將輸入框的 Return Key 屬性改為 Done,然後建立一個方法並連到 Did End On Exit:
- (IBAction)textFieldDoneEditing:(id)sender {
[sender resignFirstResponder];
}
本質上與方法一相同,只是把目標按鈕放大成整顆鍵盤的右下區域,好按一些。仍然需要使用者精確點擊。
在 viewDidLoad 中掛一個點擊手勢:
UITapGestureRecognizer *tap = [[UITapGestureRecognizer alloc] initWithTarget:self action:@selector(dismissKeyboard)]; [self.view addGestureRecognizer:tap];
實作回呼方法:
- (void)dismissKeyboard {
[self.birdNameInput resignFirstResponder];
}
若畫面上有多個 textField,逐一列出來很麻煩,可以改成遍歷:
- (void)dismissKeyboard {
for (id objInput in [self.view subviews]) {
if ([objInput isKindOfClass:[UITextField class]]) {
UITextField *theTextField = objInput;
if ([objInput isFirstResponder]) {
[theTextField resignFirstResponder];
}
}
}
}
這個做法直覺、成本低,是實務上最常用的方案。但要注意兩個限制:一是遍歷只涵蓋直接子視圖,若 textField 嵌在更深的層級就找不到;二是手勢會與其他點擊互動搶事件,例如點擊按鈕時可能變成「先收鍵盤、還要再點一次才觸發按鈕」。
另一種等效做法是直接在 Storyboard 裡拉一個 Tap Gesture Recognizer 到 view 上,再連到一個 IBAction,不必寫建立手勢的程式碼。
為 view 拉一個 Touch Down 事件,連到:
- (IBAction)backgroundTap:(id)sender {
for (id objInput in [self.view subviews]) {
if ([objInput isKindOfClass:[UITextField class]]) {
UITextField *theTextField = objInput;
if ([objInput isFirstResponder]) {
[theTextField resignFirstResponder];
}
}
}
}
如果 view 沒有 Touch Down 事件可用,可以把它的父類從 UIView 改成 UIControl 或 UIButton 以取得該事件。效果與方法三接近,但綁的是 view 自身的事件而非手勢。
- (void)touchesBegan:(NSSet *)touches withEvent:(UIEvent *)event {
[self.view endEditing:YES];
}
endEditing: 會在目前的視圖階層中找出第一響應者,請它放棄焦點。傳入 YES 表示強制,不詢問對方是否願意。
比 resignFirstResponder 好的地方是:不必知道是哪個輸入框,一行解決。
但這個方法有個關鍵缺陷:如果空白區域上還有按鈕,而按鈕自己處理了 touches(不呼叫 super),那麼 viewController 的 touchesBegan 根本不會被呼叫,鍵盤也就收不起來。在控制項密集的畫面上,這方法經常失效。
建立一個繼承 UIView 的類別,覆寫 hitTest:
- (UIView *)hitTest:(CGPoint)point withEvent:(UIEvent *)event {
UIView *result = [super hitTest:point withEvent:event];
[self endEditing:YES];
return result;
}
然後把視圖控制器的主視圖類別改成這個自訂類別。從此點擊螢幕任何位置都會收起鍵盤。
為什麼這個方式最好?原因在 hitTest 的呼叫時機:鍵盤上的觸摸不會被 App 註冊,因此 hitTest 只在使用者觸碰、捲動、滑動、縮放畫面其他區域時才會被呼叫。相較之下:
唯一要留意的是:hitTest 在一次觸摸中會被呼叫很多次,方法體內要保持輕量,不要放入重運算。
另外,iOS 提供了鍵盤相關的通知(UIKeyboardWillShowNotification、UIKeyboardWillHideNotification),若你需要的不只是收起鍵盤,還包括調整版面避免被遮擋,那套通知才是正確的起點。