# BATextField
[](https://github.com/BAHome "BAHome Team")
 
  [](http://weibo.com/538298123)
## 1、功能及简介
* 1、用分类封装 UITextField，代码无任何侵入更改
* 2、用 block 方式实现所需代理回调，更加方便，代码更简洁
* 3、一个属性搞定 最大长度限制
* 4、一个属性搞定 placeholder 字体、字体颜色
* 5、一行代码搞定 输入的内容是否为空
* 6、一行代码搞定 选中所有文字、选中指定范围的文字
* 7、一行代码搞定 输入历史记录
* 8、新增 一次性移除掉 NSUserDefaults 中保存的所有的数据 封装
* 9、新增 小数点后几位数判断，可以设置小数点后 N位数，还可以判断首位数是否可以为 0
## 2、图片示例
## 3、安装、导入示例和源码地址
* 1、pod 导入【最新版本：】：
`pod 'BATextField'`
如果发现 `pod search BATextField` 搜索出来的不是最新版本，需要在终端执行 cd 转换文件路径命令退回到 desktop，然后执行 `pod setup` 命令更新本地spec缓存（可能需要几分钟），然后再搜索就可以了。
具体步骤：
- pod setup : 初始化
- pod repo update : 更新仓库
- pod search BATextField
* 2、文件夹拖入：下载demo，把 BATextField 文件夹拖入项目即可，
* 3、导入头文件：
` #import "BATextField.h" `
* 4、项目源码地址：
OC 版 ：[https://github.com/BAHome/BATextField](https://github.com/BAHome/BATextField)
## 4、BATextField 的类结构及 demo 示例
### UITextField+BAKit.h
```
#import
#import
typedef void (^BAKit_textFieldDidEndEditingBlock)(UITextField *textField);
@interface UITextField (BAKit)
@property(nonatomic, copy) BAKit_textFieldDidEndEditingBlock textFieldDidEndEditingBlock;
/**
UITextField：placeholder：文字颜色，默认：黑色
*/
@property(nonatomic, strong) UIColor *ba_placeholderColor;
/**
UITextField：placeholder：文字字体
*/
@property(nonatomic, strong) UIFont *ba_placeholderFont;
/**
UITextField：限制最大输入长度
*/
@property(nonatomic, assign) NSInteger ba_maxLength;
/**
UITextField：小数点后的最大位数，默认：无，
注意：如果需要使用此方法，键盘默认为 UIKeyboardTypeDecimalPad，请务必遵循两步：
// 先设置 _textField2 的代理
[_textField2 ba_textField_setDelegate:_textField2];
// 再设置小数点后的位数，如果不使用 ba_maxDecimalPointNumber ，请务必删除 上面的代理，以免出现其他异常
_textField2.ba_maxDecimalPointNumber = 2;
*/
@property(nonatomic, assign) NSInteger ba_maxDecimalPointNumber;
/**
UITextField：是否包含小数点，默认：NO
*/
@property(nonatomic, assign) BOOL ba_isHaveDecimalPoint;
/**
UITextField：首位数是否可以为 0，默认：NO
*/
@property(nonatomic, assign) BOOL ba_isFirstNumberZero;
/**
UITextField：首先设置代理
@param delegate delegate description
*/
- (void)ba_textField_setDelegate:(id)delegate;
/**
UITextField：判断 UITextField 输入的内容是否为空
@return YES，NO
*/
- (BOOL)ba_textField_isEmpty;
/**
UITextField：选中所有文字
*/
- (void)ba_textField_selectAllText;
/**
UITextField：当前选中的字符串范围
@return NSRange
*/
- (NSRange)ba_textField_selectedRange;
/**
UITextField：选中指定范围的文字
@param range NSRange 范围
*/
- (void)ba_textField_setSelectedRange:(NSRange)range;
```
## UITextField+BAHistory.h
```
#import
@interface UITextField (BAHistory)
/**
textFieldID：识别 ID，要用到历史记录，请务必添加
*/
@property(nonatomic, strong) NSString *ba_textFieldID;
/**
历史数据数组
*/
@property(nonatomic, readonly, strong) NSArray *ba_textFieldHistoryArray;
/**
clearButton 标题，默认：清楚历史内容
*/
@property(nonatomic, strong) NSString *ba_clearButtonTitle;
/**
clearButton 标题颜色，默认：[[UIColor blueColor] colorWithAlphaComponent:0.5f]
*/
@property(nonatomic, strong) UIColor *ba_clearButtonTitleColor;
/**
同步输入内容到 NSUserDefaults
*/
- (void)ba_textFieldHistoryArraySynchronize;
/**
显示 HistoryArray
*/
- (void)ba_textFieldHistoryArrayShow;
/**
隐藏 HistoryArray
*/
- (void)ba_textFieldHistoryArrayHide;
/**
清除 HistoryArray
*/
- (void)ba_textFieldHistoryArrayClear;
@end
```
### demo 示例
```
// 示例1：自定义 placeholder 字体和颜色，限制最大位数为 6 位！
- (UITextField *)textField
{
if (!_textField)
{
_textField = [UITextField new];
_textField.placeholder = @"这里是 placeholder！限制最大位数：6！";
_textField.backgroundColor = BAKit_Color_Gray_11_pod;
// placeholder：文字颜色
_textField.ba_placeholderColor = BAKit_Color_Green_pod;
// placeholder：文字字体
_textField.ba_placeholderFont = [UIFont systemFontOfSize:11];
// 限制最大输入长度
_textField.ba_maxLength = 6;
[self.view addSubview:_textField];
}
return _textField;
}
// 示例2：点击 return 后，可以保存输入历史，限制最大位数为 6 位！
- (UITextField *)textField1
{
if (!_textField1)
{
_textField1 = [UITextField new];
_textField1.placeholder = @"点击 return 后，可以保存输入历史！【限制输入11位】";
_textField1.backgroundColor = BAKit_Color_Gray_11;
_textField1.delegate = self;
// placeholder：文字颜色，默认：黑色
_textField1.ba_placeholderColor = BAKit_Color_Orange;
// placeholder：文字字体
_textField1.ba_placeholderFont = [UIFont boldSystemFontOfSize:13];
// 限制最大输入长度
_textField1.ba_maxLength = 11;
// textFieldID：识别 ID，要用到历史记录，请务必添加
_textField1.ba_textFieldID = @"user_account";
// clearButton 标题，默认：清楚历史内容
_textField1.ba_clearButtonTitle = @"clear";
// clearButton 标题颜色，默认：[[UIColor blueColor] colorWithAlphaComponent:0.5f]
_textField1.ba_clearButtonTitleColor = BAKit_Color_Green;
[self.view addSubview:_textField1];
}
return _textField1;
}
- (void)touchesBegan:(NSSet *)touches withEvent:(UIEvent *)event
{
[self.view endEditing:YES];
[_textField1 ba_textFieldHistoryArrayHide];
}
#pragma mark - UITextFieldDelegate
- (BOOL)textFieldShouldBeginEditing:(UITextField *)textField
{
if (_textField1 == textField)
{
// 当开始编辑的时候，显示 历史数据
[_textField1 ba_textFieldHistoryArrayShow];
return YES;
}
return NO;
}
- (BOOL)textFieldShouldReturn:(UITextField *)textField
{
if (_textField1 == textField)
{
// 点击 return，一定要记得 同步数据
[_textField1 ba_textFieldHistoryArraySynchronize];
// 同步完数据后，记得隐藏 历史数据
[_textField1 ba_textFieldHistoryArrayHide];
_textField1.text = nil;
[_textField1 resignFirstResponder];
return YES;
}
return NO;
}
// 示例3：限制输入小数点后 N 位数，首字母是否可以为 0
- (UITextField *)textField2
{
if (!_textField2)
{
_textField2 = [UITextField new];
_textField2.placeholder = @"限制输入小数点后 2 位！";
_textField2.backgroundColor = BAKit_Color_Gray_11_pod;
_textField2.keyboardType = UIKeyboardTypeDecimalPad;
// placeholder：文字颜色，默认：黑色
// _textField2.ba_placeholderColor = BAKit_Color_Orange_pod;
// placeholder：文字字体
// _textField2.ba_placeholderFont = [UIFont boldSystemFontOfSize:13];
// 限制最大输入长度
// _textField2.ba_maxLength = 11;
// 先设置 _textField2 的代理
[_textField2 ba_textField_setDelegate:_textField2];
// 再设置小数点后的位数，如果不使用 ba_maxDecimalPointNumber ，请务必删除 上面的代理，以免出现其他异常
_textField2.ba_maxDecimalPointNumber = 2;
// 设置首位数是否可以为 0，默认：NO
_textField2.ba_isFirstNumberZero = YES;
[self.view addSubview:_textField2];
}
return _textField2;
}
其他示例可下载 demo 查看源码！
```
## 5、更新记录：【倒叙】
欢迎使用 [【BAHome】](https://github.com/BAHome) 系列开源代码 ！
如有更多需求，请前往：[【https://github.com/BAHome】](https://github.com/BAHome)
最新更新时间：2018-07-03 【倒叙】
最新Version：【Version：1.0.5】
更新内容：
1.0.5.1、新增 textFieldDidEndEditingBlock
最新更新时间：2017-09-15 【倒叙】
最新Version：【Version：1.0.4】
更新内容：
1.0.4.1、新增 小数点后几位数判断，可以设置小数点后 N位数，还可以判断首位数是否可以为 0
最新更新时间：2017-08-21 【倒叙】
最新Version：【Version：1.0.3】
更新内容：
1.0.3.1、新增 一次性移除掉 NSUserDefaults 中保存的所有的数据 封装
最新更新时间：2017-06-24 【倒叙】
最新Version：【Version：1.0.2】
更新内容：
1.0.2.1、优化部分宏定义
最新更新时间：2017-06-23 【倒叙】
最新Version：【Version：1.0.1】
更新内容：
1.0.1.1、优化部分宏定义
最新更新时间：2017-06-17 【倒叙】
最新Version：【Version：1.0.0】
更新内容：
1.0.0.1、用分类封装 UITextField，代码无任何侵入更改
1.0.0.2、用 block 方式实现所需代理回调，更加方便，代码更简洁
1.0.0.3、一个属性搞定 最大长度限制
1.0.0.4、一个属性搞定 placeholder 字体、字体颜色
1.0.0.5、一行代码搞定 输入的内容是否为空
1.0.0.6、一行代码搞定 选中所有文字、选中指定范围的文字
1.0.0.7、一行代码搞定 输入历史记录
## 6、bug 反馈
> 1、开发中遇到 bug，希望小伙伴儿们能够及时反馈与我们 BAHome 团队，我们必定会认真对待每一个问题！
> 2、以后提需求和 bug 的同学，记得把 git 或者博客链接给我们，我直接超链到你们那里！希望大家积极参与测试！
## 7、BAHome 团队成员
> 1、QQ 群
479663605
【注意：此群为 2 元 付费群，介意的小伙伴儿勿扰！】
> 孙博岩
QQ：137361770
git：[https://github.com/boai](https://github.com/boai)
简书：[http://www.jianshu.com/u/95c9800fdf47](http://www.jianshu.com/u/95c9800fdf47)
微博：[](http://weibo.com/538298123)
> 马景丽
QQ：1253540493
git：[https://github.com/MaJingli](https://github.com/MaJingli)
> 陆晓峰
QQ：442171865
git：[https://github.com/zeR0Lu](https://github.com/zeR0Lu)
> 陈集
QQ：3161182978
git：[https://github.com/chenjipdc](https://github.com/chenjipdc)
简书：[http://www.jianshu.com/u/90ae559fc21d](http://www.jianshu.com/u/90ae559fc21d)
> 任子丰
QQ：459643690
git：[https://github.com/renzifeng](https://github.com/renzifeng)
> 吴丰收
QQ：498121294
> 石少庸
QQ：363605775
git：[https://github.com/CrazyCoderShi](https://github.com/CrazyCoderShi)
简书：[http://www.jianshu.com/u/0726f4d689a3](http://www.jianshu.com/u/0726f4d689a3)
## 8、开发环境 和 支持版本
> 开发使用 最新版本 Xcode，理论上支持 iOS 8 及以上版本，如有版本适配问题，请及时反馈！多谢合作！
## 9、感谢
> 感谢 [BAHome](https://github.com/BAHome) 团队成员倾力合作，后期会推出一系列 常用 UI 控件的封装，大家有需求得也可以在 issue 提出，如果合理，我们会尽快推出新版本！
> [BAHome](https://github.com/BAHome) 的发展离不开小伙伴儿的信任与推广，再次感谢各位小伙伴儿的支持！