做表單時經常會遇到「這個欄位最多只能填幾個字」的需求,例如手機號碼、驗證碼、簡短備註。與其等使用者按完送出再跳錯誤訊息,不如在輸入的當下就攔住,體驗會好得多。
在 iOS 裡,攔截輸入的正確位置是 UITextField 的 delegate 方法 textField:shouldChangeCharactersInRange:replacementString:。這個方法會在字元真正被寫入文字欄之前被呼叫,回傳 YES 代表放行,回傳 NO 代表拒絕這次變更。
- (BOOL)textField:(UITextField *)textField
shouldChangeCharactersInRange:(NSRange)range
replacementString:(NSString *)string {
// 換行鍵直接放行
if ([string isEqualToString:@"/n"]) {
return YES;
}
// 先模擬「套用這次輸入之後」的完整字串
NSString *aString = [textField.text stringByReplacingCharactersInRange:range
withString:string];
if (self.searchTextField == textField) {
if ([aString length] > 5) {
textField.text = [aString substringToIndex:5];
UIAlertView *alert = [[UIAlertView alloc] initWithTitle:nil
message:@"超過最大字數不能輸入了"
delegate:nil
cancelButtonTitle:@"Ok"
otherButtonTitles:nil, nil];
[alert show];
[alert release];
return NO;
}
}
return YES;
}
為什麼要先組出 aString?使用者可能是在游標處插入,也可能是選取一段文字後覆蓋,甚至是一次貼上多個字。range 描述的是「即將被替換的範圍」,直接拿 textField.text.length + string.length 去算會失準。用 stringByReplacingCharactersInRange:withString: 模擬一次,得到的才是真正的最終結果。
為什麼要寫 textField.text = ...?當貼上的內容超長時,如果只回傳 NO,使用者會發現「什麼都沒發生」,摸不著頭緒。先把截斷後的結果寫回去,再回傳 NO 阻止這次變更,視覺上就變成「貼上被自動裁切成 5 個字」,反饋清楚多了。
別忘了 delegate。這段程式碼要生效,必須先設定 textField.delegate = self; 並宣告遵循 UITextFieldDelegate 協定,否則方法永遠不會被呼叫。
範例中的 UIAlertView 從 iOS 7 起已被標記為不建議使用,目前應改用 UIAlertController:
UIAlertController *alert =
[UIAlertController alertControllerWithTitle:nil
message:@"超過最大字數不能輸入了"
preferredStyle:UIAlertControllerStyleAlert];
[alert addAction:[UIAlertAction actionWithTitle:@"Ok"
style:UIControlStyleDefault
handler:nil]];
[self presentViewController:alert animated:YES completion:nil];
另外, ARC 專案請拿掉 [alert release];,手動釋放與 ARC 混用會直接崩潰。若你使用的是 Swift,同樣的邏輯寫成 textField(_:shouldChangeCharactersIn:replacementString:),判斷方式完全一致。
如果同一畫面上有多個輸入框、各自有不同的字數上限,可以把上限抽成一個 dictionary,用 textField 當 key 去查表,避免寫出一長串 if-else。這是讓這類小功能保持整潔的常用手法。