本文示範如何實作一個類似微信輸入列的元件,重點在於「高度隨內容自適應」與「隨鍵盤浮動」這兩件麻煩事。
要達成的功能有:
1. 有一個 placeholder 提示文字,開始輸入後消失,全部刪除後重新出現。
2. 文字框下方有一條藍色細線標示輸入範圍,類似微信裡那條綠色底線。
3. 輸入框會隨鍵盤上下浮動,並在文字變多時自動增高與調整位置。
4. 右側發送按鈕在無文字時呈灰色表示不可送,有文字時變藍色可送,且高度需跟著輸入框變化。
5. 頂部有一條與其上方視圖分隔的細線。
6. 輸入完成後,點鍵盤 Done 或點發送按鈕都能把文字輸出。
依職責可以把整個元件拆成三塊:分隔線(高度 1 的 UIView)、具備 placeholder 能力的多行輸入框、以及發送按鈕。
UITextView 本身沒有 placeholder,因此用「UITextView + UILabel + UIImageView(藍線)」組合。文字變化的偵測則靠監聽 UITextViewTextDidChangeNotification。
先宣告一個繼承自 UITextView 的類,在標頭檔暴露 placeText 與 placeColor 供外部設定:
#pragma mark - 建立 placeholder 標籤
- (void)setupPlaceTextLabel {
if (self.placeText.length > 0) {
if (!_placeTextLab) {
CGRect frame = CGRectMake(8, 8, self.bounds.size.width - 16, 0);
_placeTextLab = [[UILabel alloc] initWithFrame:frame];
_placeTextLab.font = self.font;
_placeTextLab.backgroundColor = [UIColor clearColor];
_placeTextLab.textColor = self.placeColor;
_placeTextLab.tag = 999;
_placeTextLab.alpha = 0;
_placeTextLab.lineBreakMode = NSLineBreakByWordWrapping;
_placeTextLab.numberOfLines = 0;
[self addSubview:_placeTextLab];
}
_placeTextLab.text = self.placeText;
[_placeTextLab sizeToFit];
[_placeTextLab setFrame:CGRectMake(8, 8, CGRectGetWidth(self.bounds) - 16, CGRectGetHeight(_placeTextLab.frame))];
}
if (self.text.length == 0 && self.placeText.length > 0) {
[[self viewWithTag:999] setAlpha:1.0];
}
}
藍色底線用一張單像素高的 PNG 來做,記得把 UIImageView 的 contentMode 設為 ScaleToFill,否則拉伸後會變形:
- (void)addLineView {
[_subLine removeFromSuperview];
_subLine = [[UIImageView alloc] initWithImage:[UIImage imageNamed:@"subline.png"]];
[_subLine setContentMode:UIViewContentModeScaleToFill];
[self addSubline:_subLine];
}
UITextView 的初始化相對麻煩,需要自訂一個帶參數的建構子:
- (instancetype)initWithFrame:(CGRect)frame
PlaceText:(NSString *)placeText
PlaceColor:(UIColor *)placeColor {
self = [super initWithFrame:frame];
if (self) {
self.scrollEnabled = NO;
_placeText = placeText;
_placeColor = placeColor;
_Textnil = YES;
[[NSNotificationCenter defaultCenter] addObserver:self
selector:@selector(TextChange:)
name:UITextViewTextDidChangeNotification
object:nil];
}
return self;
}
一開始我以為只要監聽 UITextViewTextDidChangeNotification,就能即時掌握高度變化。結果發現:當輸入到第一行結尾、再按換行後,高度居然沒有變;要等到輸入下一行的第二個字,高度才更新。研判是通知發送的時機早於版面配置完成,導致拿到的資料是舊值。
解法是改用 UITextView 自帶的 sizeThatFits:,讓系統直接算出符合內容所需的尺寸:
CGSize size = [self sizeThatFits:CGSizeMake(self.contentSize.width, 1000.0)];
完整監聽方法:
- (void)TextChange:(NSNotification *)notification {
if (self.text.length == 0) {
_Textnil = YES;
} else {
_Textnil = NO;
}
[self addLineView];
if (self.placeText.length == 0) {
return;
}
[UIView animateWithDuration:0.5 animations:^{
if (_Textnil) {
[[self viewWithTag:999] setAlpha:1.0];
} else {
[[self viewWithTag:999] setAlpha:0];
}
}];
}
輸入框會隨文字增高,父視圖也必須跟著長高。用 delegate 當然可行,但對這種單純的數值回報顯得有點重量級,用 Block 更輕巧——這也是 AFNetworking 到處用 block、而前輩 ASIHTTPRequest 到處是 delegate 的原因。
- (void)addSubline:(UIView *)view {
CGSize size = [self sizeThatFits:CGSizeMake(self.contentSize.width, 1000.0)];
if (view) {
CGRect frame = CGRectMake(2, size.height - 3, self.bounds.size.width - 4, 3.0);
view.frame = frame;
}
[self addSubview:view];
self.viewSize(size); // 透過 block 把新尺寸回報出去
}
使用方式:先宣告一個 block 私有變數,再寫一個方法供外部賦值,由呼叫方決定收到新尺寸後要做什麼,最後像 delegate 一樣呼叫即可。
主要輸入框完成後,新建一個 UIView 子類負責整體佈局。這個容器的高度需與鍵盤高度保持一致的關係,做法是監聽 UIKeyboardWillChangeFrameNotification,即時調整位置:
- (void)keyboardWillShow:(NSNotification *)notification {
NSDictionary *userInfo = [notification userInfo];
NSTimeInterval boardAnimationDuration =
[[userInfo objectForKey:UIKeyboardAnimationDurationUserInfoKey] doubleValue];
CGRect frame =
[[userInfo objectForKey:UIKeyboardFrameEndUserInfoKey] CGRectValue];
[UIView animateWithDuration:boardAnimationDuration
delay:0.0f
options:UIViewAnimationOptionCurveEaseInOut
animations:^{
CGFloat keyBoardY = frame.origin.y;
CGFloat keyBoardHeigh = frame.size.height;
maxy = [UIScreen mainScreen].bounds.size.height - keyBoardHeigh;
CGRect frame = self.frame;
frame.origin.y = keyBoardY - CGRectGetHeight(self.frame);
self.frame = frame;
} completion:^(BOOL finished) {
}];
}
這裡的 maxY 是輸入框在 Y 軸上的標準停放位置:沒有鍵盤時等於螢幕高度,有鍵盤時等於鍵盤頂端座標。接著在內容高度變化時同步調整容器高度:
- (void)TextViewDidChange:(CGSize)size {
self.frame = CGRectMake(0, self.frame.origin.y, self.frame.size.width, size.height + 6 * 2);
self.frame = CGRectMake(0, maxy - self.frame.size.height, self.frame.size.width, self.frame.size.height);
_Inputview.frame = CGRectMake(10, 6, self.frame.size.width - K_right_padding, size.height);
}
以上兩個方法就是整個元件最關鍵的部分:UIView 高度自適應與位置貼齊鍵盤。
對外溝通同樣採用 Block:
@property (nonatomic, copy) void (^sendText)(NSString *);
- (void)sendMessage:(void (^)(NSString *text))inputText {
if (inputText) {
self.sendText = inputText;
}
}
- (void)buttonClick {
[self sendInputText];
}
- (void)sendInputText {
if (_Inputview.Textnil) {
return;
} else {
if (self.sendText) {
self.sendText(_Inputview.text);
_Inputview.text = @"";
}
}
}
一、maxy 應在 viewDidLoad 時先給初值,否則鍵盤尚未彈出前用它算位置會得到錯誤結果。
二、鍵盤通知記得在 dealloc 中移除,並注意 iOS 某些版本會連續發送多次 notification,最好加上「位置未變則不重排」的判斷避免動畫抖動。
三、發送後清空文字時,記得同步呼叫一次高度重算,否則輸入框會停在放大的狀態不會縮回。