為UITextField增加MaxLength特性


 

iOS

實現方案

在 HTML 的世界里,輸入框天生就有 MaxLength 屬性,可以限制用戶輸入的最大字符數量

可惜 iOS 上對應的 UITextField 並沒有這樣方便的屬性,只有自己動手來實現

MaxLength 的實現並不難,如果去 StackOverflow 上搜一下,能看到大量的答案,比如這個回答,基本原理都是這樣

truncate

- (BOOL)textField:(UITextField *) textField shouldChangeCharactersInRange:(NSRange)range replacementString:(NSString *)string {

 

    NSUInteger oldLength = [textField.text length];

    NSUInteger replacementLength = [string length];

    NSUInteger rangeLength = range.length;

 

    NSUInteger newLength = oldLength - rangeLength + replacementLength;

 

    BOOL returnKey = [string rangeOfString: @"\n"].location != NSNotFound;

 

    return newLength <= MAXLENGTH || returnKey;

}

即通過 textField:shouldChangeCharactersInRange:replacementString 方法,來決定用戶是否還能繼續輸入

但是如果你直接抄了這段代碼,一定會被細心的測試同學提 BUG,為什么呢?因為老外不用輸入法啊!比如下圖這種場景

 

在開啟中文輸入法時,如果當前只剩一個字符可以輸入,那么想再輸入一個漢字基本不太可能

因為打出的拼音也會出現在輸入框里,而且會觸發上述方法,那么咋辦呢?直接看代碼

truncate

// 添加監聽

[[NSNotificationCenter defaultCenter] addObserver:self

                                         selector:@selector(textFieldDidChanged:)

                                             name:UITextFieldTextDidChangeNotification

                                           object:self.textField];

 

// 監聽處理

- (void)textFieldDidChanged:(NSNotification *)notification {

    NSString *text = self.textField.text;

 

    // 拼音輸入時,拼音字母處於選中狀態,此時不判斷是否超長

    UITextRange *selectedRange = [self.textField markedTextRange];

    if (!selectedRange || !selectedRange.start) {

        if (text.length > MAXLENGTH) {

            self.textField.text = [text substringToIndex:MAXLENGTH];

        }

    }

}

 

這里主要使用了兩個知識:

  • 輸入法輸入時,拼音字母或者筆畫處於選中狀態,可以使用 markedTextRange 獲取到
  • 普通輸入,以及將輸入法的待選字填入輸入框時,都會發出 UITextFieldTextDidChangeNotification, 可以監聽這個通知,並事后對 UITextField 的內容做清理

另外除了使用監聽 NSNotification 的方式,也可以使用 addTargetAction 的方式,代碼如下:

truncate

[self.textField addTarget:self

                   action:@selector(textChange:)

         forControlEvents:UIControlEventEditingChanged];

這與上面的方式是等價的,但是使用 NSNotification 需要在對象銷毀時 removeObserver,而這種方式不需要

下面講封裝時會提到這一點

如何封裝

如果項目中很多地方都需要 MaxLength 特性,那么最好做一下封裝,減少代碼重復,那么怎么做呢?

子類化

首先想到的是創建 UITextField 的子類,在子類中增加一個 MaxLength 屬性,並在用戶設置屬性時增加通知監聽處理

這樣所有的地方都使用這個子類就好啦,不過使用子類有這么幾個缺點:

  • 一些額外的工作量,因為所有用到的地方都要改為這個子類
  • 由於 OC 不支持多重繼承,那么如果將來還需要封裝其他特性的話,就只能再創建這個子類的子類,靈活性會非常差

使用 Category

如果我們能直接為 UITextField 增加 maxLength 屬性就好了

OC 中有 Category 語法,可以為已有的類增加新的方法,但並不支持增加新的屬性(想念 Ruby 的 Mixin T_T)

幸運的是有折衷的辦法能夠實現,可以參考Associated Objects,這里就不贅述了,直接上代碼

truncate

// UITextField+MaxLength.h

 

@interface UITextField (MaxLength)

@property (assign, nonatomic) NSUInteger maxLength;

@end

 

 

// UITextField+MaxLength.m

 

static char kMaxLength;

@implementation UITextField (MaxLength)

@dynamic maxLength;

 

- (void)setMaxLength:(NSUInteger)maxLength {

    objc_setAssociatedObject(self, &kMaxLength, @(maxLength), OBJC_ASSOCIATION_RETAIN_NONATOMIC);

    if (maxLength) {

        // 代碼

    }

}

 

- (NSUInteger)maxLength {

    NSNumber *number = objc_getAssociatedObject(self, &kMaxLength);

    return [number integerValue];

}

 

@end

我們在 setMaxLength 方法里面增加監聽與處理的方法即可

如果使用的是 NSNotification,我們還需要在對象銷毀時移除監聽,在 Category 中增加這個方法

truncate

- (void)dealloc {

    [[NSNotificationCenter defaultCenter] removeObserver:self];

}

不過測試一下就知道,這么做是有問題的,因為我們覆蓋了原生 UITextField 的 dealloc 方法,會導致應用崩潰

反而使用子類的話不會有問題,調用 [super dealloc] 即可

怎么辦呢?兩個方法,一是換用上面提到的 addTargetAction 方式,二是使用 Method Swizzling 這種高級用法,參考代碼

truncate

//...

#import <objc/runtime.h>

#import <objc/message.h>

 

+ (void)load {

    Method origMethod = class_getInstanceMethod([self class], NSSelectorFromString(@"dealloc"));

    Method newMethod = class_getInstanceMethod([self class], @selector(my_dealloc));

    method_exchangeImplementations(origMethod, newMethod);

}

 

- (void)my_dealloc {

    [[NSNotificationCenter defaultCenter] removeObserver:self];

    [self my_dealloc];

}

Swizzling 也不細說了,資料非常多,與 Ruby 中的 alias method chain 倒是挺像的

IB_DESIGNABLE

如果你像我一樣,喜歡使用 Xib 的話,一定會希望能夠在 Xib 的屬性面板里增加這個屬性

再次幸運的是,Apple 也提供了這樣的方式,可以參考CreatingaLiveViewofaCustomObject

根據文章,只需要對 .h 文件略作修改即可

truncate

IB_DESIGNABLE

 

@interface UITextField (MaxLength)

 

@property (assign, nonatomic) IBInspectable NSUInteger maxLength;

 

@end

效果如圖

 

最后,放一下代碼,以供參考https://github.com/edokeh/UITextField-MaxLength


 

UITextView的分類(添加占位文字和最大輸入個數)

144 作者 此生逍遙 2017.04.23 06:04 字數 424 閱讀 65評論 0

思路:

1、通過runtime添加兩個字符串屬性,供外接訪問。一個為設置占位字符串(placeholder)使用,一個為設置最大文字個數(limitLength)使用。
2、通過runtime將UITextView和兩個UILabel關聯起來,一個用做顯示占位字符串(placeholderLabel)使用,一個用做顯示最大文字個數(wordCountLabel)使用。
3、在占位字符串(placeholder)和最大文字個數(limitLength)的set方法中分別調用第二步中兩個UILabel的初始化方法。
4、注冊兩個通知(通知的名字都叫:UITextViewTextDidChangeNotification,但監聽方法不一樣):一個用作監聽UITextView輸入字數,有則不顯示占位文字,沒有就顯示占位文字。另一個用作監聽是否超過最大輸入字數使用,沒有超過可繼續使用,超過則截取到最大字數,后面的不顯示,也無法輸入。(倘若提示用戶超出最大字數,可以在通知的監聽方法中判斷提示)

效果圖如下:


效果圖
此分類使用的時候,只是在正常創建UITextView時多了兩個屬性設置:
self.addessalDetailTextView.placeholder = @"請填寫詳細地址,不少於120個字";
self.addessalDetailTextView.limitLength = @120;

具體使用代碼如下(是不是代碼很少):

UITextView *textView = [[UITextView alloc] init];
textView.frame = CGRectMake(10, 10, 300, 150);
textView.center = self.view.center;
textView.placeholder = @"請填寫詳細地址,不多於120個字";
textView.limitLength = @120;
[self.view addSubview:textView];

也可以使用xib關聯,簡單方便。

下面就看分類(UITextView+CLTextView)的具體實現:

1、UITextView+CLTextView.h的實現,這也就是思路中的第一步

@property (nonatomic,strong) NSString *placeholder;//占位符
@property (copy, nonatomic) NSNumber *limitLength;//字數限制

2、UITextView+CLTextView.m的實現

引入#import <objc/runtime.h>頭文件

@interface UITextView ()
@property (nonatomic,strong) UILabel *placeholderLabel;//占位符
@property (nonatomic,strong) UILabel *wordCountLabel;//計算字數
@end
@implementation UITextView (YLTextView)

static NSString *PLACEHOLDLABEL = @"placelabel";
static NSString *PLACEHOLD = @"placehold";
static NSString *WORDCOUNTLABEL = @"wordcount";
static const void *limitLengthKey = &limitLengthKey;


#pragma mark -- setter/getter方法

//顯示占位符label的setter/getter方法
-(void)setPlaceholderLabel:(UILabel *)placeholderLabel {
objc_setAssociatedObject(self, &PLACEHOLDLABEL, placeholderLabel, OBJC_ASSOCIATION_RETAIN_NONATOMIC);
}

- (UILabel *)placeholderLabel {
return objc_getAssociatedObject(self, &PLACEHOLDLABEL);
}

//顯示字數label的setter/getter方法
- (void)setWordCountLabel:(UILabel *)wordCountLabel {
objc_setAssociatedObject(self, &WORDCOUNTLABEL, wordCountLabel, OBJC_ASSOCIATION_RETAIN_NONATOMIC);
}

- (UILabel *)wordCountLabel {
return objc_getAssociatedObject(self, &WORDCOUNTLABEL);
}

//供外接訪問的占位字符串,以便設置占位文字的setter/getter方法
- (void)setPlaceholder:(NSString *)placeholder {
objc_setAssociatedObject(self, &PLACEHOLD, placeholder, OBJC_ASSOCIATION_RETAIN_NONATOMIC);
[self setPlaceHolderLabel:placeholder];
}

- (NSString *)placeholder {
return objc_getAssociatedObject(self, &PLACEHOLD);
}

//供外接訪問的最大輸入字數,設置最大文字個數的setter/getter方法
- (NSNumber *)limitLength {
return objc_getAssociatedObject(self, limitLengthKey);
}

- (void)setLimitLength:(NSNumber *)limitLength {
objc_setAssociatedObject(self, limitLengthKey, limitLength, OBJC_ASSOCIATION_COPY_NONATOMIC);

[self addLimitLengthObserver:[limitLength intValue]];
[self setWordcountLable:limitLength];
}

#pragma mark -- 配置占位符標簽
- (void)setPlaceHolderLabel:(NSString *)placeholder {

[[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(textFieldChanged:) name:UITextViewTextDidChangeNotification object:self];
// 占位字符

self.placeholderLabel = [[UILabel alloc] init];
self.placeholderLabel.font = [UIFont systemFontOfSize:13.];
self.placeholderLabel.text = placeholder;
self.placeholderLabel.numberOfLines = 0;
self.placeholderLabel.lineBreakMode = NSLineBreakByWordWrapping;
self.placeholderLabel.textColor = [UIColor lightGrayColor];
CGRect rect = [placeholder boundingRectWithSize:CGSizeMake(CGRectGetWidth(self.frame)-7, CGFLOAT_MAX) options:NSStringDrawingUsesLineFragmentOrigin attributes:@{NSFontAttributeName: [UIFont systemFontOfSize:13.]} context:nil];
self.placeholderLabel.frame = CGRectMake(7, 7, rect.size.width, rect.size.height);
[self addSubview:self.placeholderLabel];
self.placeholderLabel.hidden = self.text.length > 0 ? YES : NO;
}

#pragma mark -- 設置字數限制標簽
- (void)setWordcountLable:(NSNumber *)limitLength {
//字數限制
self.wordCountLabel = [[UILabel alloc] initWithFrame:CGRectMake(CGRectGetWidth(self.frame) - 65, CGRectGetHeight(self.frame) - 20, 60, 20)];
self.wordCountLabel.textAlignment = NSTextAlignmentRight;
self.wordCountLabel.textColor = [UIColor lightGrayColor];
self.wordCountLabel.font = [UIFont systemFontOfSize:13.];
if (self.text.length > [limitLength integerValue]) {
self.text = [self.text substringToIndex:[self.limitLength intValue]];
}
self.wordCountLabel.text = [NSString stringWithFormat:@"%lu/%@",(unsigned long)self.text.length,limitLength];
[self addSubview:self.wordCountLabel];
}

#pragma mark -- 注冊限制位數的通知
- (void)addLimitLengthObserver:(int)length {
[[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(limitLengthEvent) name:UITextViewTextDidChangeNotification object:self];
}

#pragma mark -- 限制輸入的位數
- (void)limitLengthEvent {

if ([self.text length] > [self.limitLength intValue]) {

self.text = [self.text substringToIndex:[self.limitLength intValue]];
}
}

#pragma mark -- NSNotification
- (void)textFieldChanged:(NSNotification *)notification {
if (self.placeholder) {
self.placeholderLabel.hidden = YES;

if (self.text.length == 0) {

self.placeholderLabel.hidden = NO;
}
}
if (self.limitLength) {

NSInteger wordCount = self.text.length;
if (wordCount > [self.limitLength integerValue]) {
wordCount = [self.limitLength integerValue];
#pragma mark -- 想提示用戶輸入已經超出最大字數可以打開此行代碼
// UIAlertView *view = [[UIAlertView alloc] initWithTitle:@"超過最大字數" message:@"您已經超出了最大字數,超出部分將無法顯示" delegate:self cancelButtonTitle:@"取消" otherButtonTitles:@"確定", nil];
// [view show];
}
self.wordCountLabel.text = [NSString stringWithFormat:@"%ld/%@",wordCount,self.limitLength];
}
}

//注銷通知
- (void)dealloc {
[[NSNotificationCenter defaultCenter] removeObserver:self
name:UITextViewTextDidChangeNotification
object:self];
}

總結:

關鍵點是:runtime的使用和通知的監聽。然后就沒什么了。

注意!

本站转载的文章为个人学习借鉴使用,本站对版权不负任何法律责任。如果侵犯了您的隐私权益,请联系我们删除。



 
粤ICP备14056181号  © 2014-2021 ITdaan.com