萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> iOS 開發

iOS 關閉鍵盤的 3 種標準姿勢

前言:iOS 無自動收鍵機制,開發者必須主動處理

三類視圖喚起鍵盤:`UITextField`、`UITextView`、`UISearchBar`。收鍵盤核心是讓當前**第一響應者** `resignFirstResponder`。

方法一:Return Key / Done 鍵收鍵盤(最標準)

Storyboard / XIB 設定

  1. 選中 Text Field
  2. Attributes Inspector → Return Key → 選 **Done** (或 Go、Search、Next 等)
  3. 連接 **Did End On Exit** 事件到 Controller

程式碼實現


// 定義 IBAction
- (IBAction)textFieldDoneEditing:(id)sender {
    [sender resignFirstResponder];
}

// 或在 Delegate 中
- (BOOL)textFieldShouldReturn:(UITextField *)textField {
    [textField resignFirstResponder];
    return YES;
}

優點:符合用戶預期、無額外代碼、支援「下一欄位」鍵盤流程。
缺點:數字鍵盤 (`UIKeyboardTypeNumberPad`) **無 Return Key**。

方法二:點擊背景/空白區域收鍵盤(通用補充)

方案 A:背景視圖改為 UIControl + Touch Down

  1. Storyboard 中選中根視圖(或容器 View)
  2. Identity Inspector → Class 改為 **UIControl**
  3. 連接 **Touch Down** 事件到 `backgroundTap:`

- (IBAction)backgroundTap:(id)sender {
    [self.view endEditing:YES]; // 一鍵收起所有輸入框鍵盤
}

方案 B:UITapGestureRecognizer(不改變視圖類別)


- (void)viewDidLoad {
    [super viewDidLoad];
    UITapGestureRecognizer *tap = [[UITapGestureRecognizer alloc] initWithTarget:self action:@selector(dismissKeyboard)];
    tap.cancelsTouchesInView = NO; // 重要:不攔截子視圖觸摸
    [self.view addGestureRecognizer:tap];
}

- (void)dismissKeyboard {
    [self.view endEditing:YES];
}

優點:適用所有鍵盤類型、不干擾其他觸摸事件。
缺點:ScrollView/TableView 中需處理 `cancelsTouchesInView` 與 `keyboardDismissMode` 協調。

方法三:ScrollView/TableView 專屬:keyboardDismissMode


// UIScrollView / UITableView / UICollectionView
scrollView.keyboardDismissMode = UIScrollViewKeyboardDismissModeOnDrag;     // 拖動時收鍵盤
scrollView.keyboardDismissMode = UIScrollViewKeyboardDismissModeInteractive; // 拖動跟隨手指互動收鍵盤 (iOS 7+)

這是列表頁、聊天介面的**最佳體驗方案**,無需手動手勢。

進階:工具類統一管理


// KeyboardManager.h
@interface KeyboardManager : NSObject
+ (void)addDismissTapGestureToView:(UIView *)view;
+ (void)setupScrollViewDismissMode:(UIScrollView *)scrollView mode:(UIScrollViewKeyboardDismissMode)mode;
@end

// KeyboardManager.m
@implementation KeyboardManager
+ (void)addDismissTapGestureToView:(UIView *)view {
    UITapGestureRecognizer *tap = [[UITapGestureRecognizer alloc] initWithTarget:self action:@selector(_dismissKeyboardForView:)];
    tap.cancelsTouchesInView = NO;
    tap.delegate = self; // 可選:實現 delegate 避免特定視圖攔截
    objc_setAssociatedObject(view, @selector(_dismissKeyboardForView:), tap, OBJC_ASSOCIATION_RETAIN_NONATOMIC);
    [view addGestureRecognizer:tap];
}

+ (void)_dismissKeyboardForView:(UITapGestureRecognizer *)gesture {
    [gesture.view endEditing:YES];
}

+ (void)setupScrollViewDismissMode:(UIScrollView *)scrollView mode:(UIScrollViewKeyboardDismissMode)mode {
    scrollView.keyboardDismissMode = mode;
}
@end

避坑指南

❌ `resignFirstResponder` 無效
確認:該視圖**確實是第一響應者** (`[textField isFirstResponder]`)、視圖未被釋放、在主執行緒呼叫。
❌ 數字鍵盤無 Done 鍵
自製 `inputAccessoryView` 加 Done 按鈕,或用背景點擊收鍵盤。
❌ 鍵盤遮擋輸入框
用 `IQKeyboardManager` 自動處理,或手動監聽 `UIKeyboardWillShowNotification` 調整 `contentInset`/frame。
❌ 多層嵌套視圖 `endEditing:YES` 不生效
確認調用在**包含輸入框的共同父視圖**上,或直接 `[UIApplication sharedApplication].keyWindow.endEditing:YES`。

總結選型

場景推薦方案
一般文字輸入Return Key + textFieldShouldReturn
數字鍵盤/無 Return Key背景 UITapGestureRecognizer
列表/聊天/長頁面ScrollView keyboardDismissMode = Interactive
複雜表單頁組合:Return Key + 背景手勢 + Toolbar Done
copyright © 萬盛學電腦網 all rights reserved