剛從其他平台轉到 iOS 時,最容易踩到的坑之一就是:UITextField 一旦貼近螢幕底部,鍵盤彈出就會把它整個蓋住,而且系統不會幫你自動挪位。與其每個頁面都手動調 frame,不如把「鍵盤閃避」邏輯抽到一個共同父類,讓所有子頁面直接繼承。
系統鍵盤高度固定為 216pt(含提示列),所以判斷很單純:開始編輯時算出 textField 底緣到畫面底部的距離,若不足 216 就把整個 view 往上推,剛好補足差值;結束編輯時再把位移量還回去。整個過程包成動畫,視覺上會順很多。
@interface BaseViewController : UIViewController <UITextFieldDelegate>
@end
後續所有頁面都繼承這個類別,就能共用同一套閃避邏輯。
int prewTag; // 記錄上一次編輯的 textField tag,各控制項 tag 不可重複
float prewMoveY; // 本次需要位移的高度
// 開始編輯:判斷是否需要上移
- (void)textFieldDidBeginEditing:(UITextField *)textField
{
CGRect textFrame = textField.frame;
float textY = textFrame.origin.y + textFrame.size.height;
float bottomY = self.view.frame.size.height - textY;
if (bottomY >= 216) // 底部空間已足夠,不必移動
{
prewTag = -1;
return;
}
prewTag = textField.tag;
float moveY = 216 - bottomY;
prewMoveY = moveY;
NSTimeInterval animationDuration = 0.30f;
CGRect frame = self.view.frame;
frame.origin.y -= moveY; // 往上移
frame.size.height += moveY; // 同時拉高,避免底部被裁掉
self.view.frame = frame;
[UIView beginAnimations:@"ResizeView" context:nil];
[UIView setAnimationDuration:animationDuration];
self.view.frame = frame;
[UIView commitAnimations];
}
// 結束編輯:還原
- (void)textFieldDidEndEditing:(UITextField *)textField
{
if (prewTag == -1) return; // 上次沒有移動過,不需還原
NSTimeInterval animationDuration = 0.30f;
CGRect frame = self.view.frame;
if (prewTag == textField.tag)
{
frame.origin.y += prewMoveY;
frame.size.height -= prewMoveY;
self.view.frame = frame;
}
[UIView beginAnimations:@"ResizeView" context:nil];
[UIView setAnimationDuration:animationDuration];
self.view.frame = frame;
[UIView commitAnimations];
[textField resignFirstResponder];
}
這裡用 tag 來配對「移動的是誰、還原的是誰」,是為了避免使用者快速的在不同欄位間切換時,位移量互相錯亂。
IDNameField.delegate = self;
只要把各頁面的 textField delegate 指向自己,鍵盤閃避就自動生效,不必每頁重寫一次。
這套寫法簡單直覺,但有兩個可以更好的地方:一是 216 這個魔術數字在不同螢幕尺寸與不同鍵盤(例如中文九宮格附帶候選列)下未必準確,正式專案建議改成監聽 UIKeyboardWillShowNotification,直接從通知的 userInfo 讀出鍵盤高度;二是直接改動 self.view.frame 會影響整頁布局,若頁面結構較複雜,改用 UIScrollView 搭配 contentInset 位移會更安全。