# BATextView
**Repository Path**: dsteam/BATextView
## Basic Information
- **Project Name**: BATextView
- **Description**: BATextView 的封装
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 1
- **Forks**: 0
- **Created**: 2017-06-01
- **Last Updated**: 2020-12-19
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# BATextView
[](https://github.com/BAHome "BAHome Team")
 
  [](http://weibo.com/538298123)
## 1、功能及简介
* 1、可以自定义 placeholder的(字体、颜色)、文字(字体、颜色)
* 2、可以自定义 输入文字的(字体、颜色)、文字(字体、颜色)
* 3、可以自动布局，自适应高度，实时监测输入文字的最大高度
* 4、可以实时监测输入文字的最大个数，可以限制最大输入文字字数
* 5、用分类整理，无需改动源码即可实现各种自定义功能
* 6、【方法新增】：默认 self.text 文字时的属性 ba_text：TextView 默认 text，注意：一定要用 ba_text 设置，用系统的 self.text 设置无效，此外，如果有默认 text，一定要在 ba_placeholder 赋值之前赋值 ba_text，要不然会出现文字颜色错乱！
* 7、【方法新增】：新增 UITextView 代理 shouldChangeTextInRange 改成 block （ba_textView_ShouldChangeTextInRangeBlock）返回，使用更加方便！
## 2、图片示例
## 3、安装、导入示例和源码地址
* 1、pod 导入【最新版本：】：
`pod 'BATextView'`
如果发现 `pod search BATextView` 搜索出来的不是最新版本，需要在终端执行 cd 转换文件路径命令退回到 desktop，然后执行 `pod setup` 命令更新本地spec缓存（可能需要几分钟），然后再搜索就可以了。
具体步骤：
- pod setup : 初始化
- pod repo update : 更新仓库
- pod search BATextView
* 2、文件夹拖入：下载demo，把 BATextView 文件夹拖入项目即可，
* 3、导入头文件：
` #import "BATextView.h" `
* 4、项目源码地址：
OC 版 ：[https://github.com/BAHome/BATextView](https://github.com/BAHome/BATextView)
## 4、BATextView 的类结构及 demo 示例
### UITextView+BAKit.h
```
#import
/*! 过期属性或方法名提醒 */
#define BAKit_TextView_Deprecated(instead) __deprecated_msg(instead)
/**
实时监测 TextView 输入文字，并返回当前文字最大高度，以便做自适应高度
@param current_textViewHeight 当前文字的最大高度
*/
typedef void (^BAKit_TextView_HeightDidChangedBlock)(CGFloat current_textViewHeight);
/**
实时监测 TextView 输入文字，并返回当前文字字符
@param current_text 当前文字的字符
*/
typedef void (^BAKit_TextView_WordDidChangedBlock)(NSString *current_text);
/**
实时监测 TextView 输入文字，来自系统代理：shouldChangeTextInRange
@param textView textView description
@param range range description
@param replacementText replacementText description
*/
typedef void (^BAKit_TextView_ShouldChangeTextInRangeBlock)(UITextView *textView, NSRange range, NSString *replacementText);
@interface UITextView (BAKit)
/**
TextView 默认 text，注意：一定要用 ba_text 设置，用系统的 self.text 设置无效，此外，如果有默认 text，一定要在 ba_placeholder 赋值之前赋值 ba_text，要不然会出现文字颜色错乱！
*/
@property(nonatomic, strong) NSString *ba_text;
/**
placeholder：placeholder文字
*/
@property(nonatomic, strong) NSString *ba_placeholder;
/**
placeholder：文字颜色
*/
@property(nonatomic, strong) UIColor *ba_placeholderColor;
/**
placeholder：文字字体
*/
@property(nonatomic, strong) UIFont *ba_placeholderFont;
/**
文字字体，注意：一定要用 ba_textFont 设置，用系统的 self.font 设置无效
*/
@property(nonatomic, strong) UIFont *ba_textFont;
/**
文字颜色，注意：一定要用 ba_textColor 设置，用系统的 self.textColor 设置无效
*/
@property(nonatomic, strong) UIColor *ba_textColor;
/**
最大高度，如果需要随文字改变高度的时候使用
*/
@property (nonatomic, assign) CGFloat ba_maxHeight;
/**
最小高度，如果需要随文字改变高度的时候使用
*/
@property (nonatomic, assign) CGFloat ba_minHeight;
/**
实时监测 TextView 输入文字，并返回当前文字，以便做自适应高度
*/
@property(nonatomic, copy) BAKit_TextView_HeightDidChangedBlock ba_textView_HeightDidChangedBlock;
/**
最大字数限制
*/
@property (nonatomic, assign) NSInteger ba_maxWordLimitNumber;
/**
实时监测 TextView 输入文字，并返回当前文字
*/
@property(nonatomic, copy) BAKit_TextView_WordDidChangedBlock ba_textView_WordDidChangedBlock; BAKit_TextView_Deprecated("该方法已过期,请使用最新方法：typedef void (^BAKit_TextView_WordDidChangedBlock)(NSString *current_text)");
/**
实时监测 TextView 输入文字，来自系统代理：shouldChangeTextInRange
*/
@property(nonatomic, copy) BAKit_TextView_ShouldChangeTextInRangeBlock ba_textView_ShouldChangeTextInRangeBlock;
#pragma mark - public method
/**
设置代理监测，如果需要监测自动高度，请务必添加这个代理，具体使用请看 demo！
@param delegate UITextViewDelegate
*/
- (void)ba_textViewWithDelegate:(id )delegate;
/**
是否为空
@return YES，NO
*/
- (BOOL)ba_textView_isEmpty;
/**
快速设定自动布局
@param maxHeight 最大高度
@param minHeight 最小高度
@param block BAKit_TextView_HeightDidChangedBlock
*/
- (void)ba_textView_autoLayoutWithMaxHeight:(CGFloat)maxHeight
minHeight:(CGFloat)minHeight
block:(BAKit_TextView_HeightDidChangedBlock)block;
/**
快速设定最大字数限制返回当前字数
@param limitNumber 最大字数限制
@param block BAKit_TextView_WordDidChangedBlock
*/
- (void)ba_textView_wordLimitWithMaxWordLimitNumber:(NSInteger)limitNumber
block:(BAKit_TextView_WordDidChangedBlock)block;
#pragma mark - 各版本过期方法名
#pragma mark version 1.0.2 过期方法名
@end
```
### demo 示例
```
- (UITextView *)textView1
{
if (!_textView1)
{
_textView1 = [UITextView new];
_textView1.backgroundColor = BAKit_Color_Gray_11;
/**
文字字体，注意：一定要用 ba_textFont 设置，用系统的 self.font 设置无效
*/
_textView1.ba_textFont = [UIFont systemFontOfSize:13];
/**
文字颜色，注意：一定要用 ba_textColor 设置，用系统的 self.textColor 设置无效
*/
_textView1.ba_textColor = [UIColor purpleColor];
_textView1.backgroundColor = BAKit_Color_Gray_11;
/**
TextView 默认 text，注意：一定要用 ba_text 设置，用系统的 self.text 设置无效，此外，如果有默认 text，一定要在 ba_placeholder 赋值之前赋值 ba_text，要不然会出现文字颜色错乱！
*/
_textView1.ba_text = @"HelloWord！";
// 自定义 placeholder
_textView1.ba_placeholder = @"test";
// _textView1.ba_placeholder = @"这里是 placeholder ！";
// 自定义 placeholder 颜色
_textView1.ba_placeholderColor = [UIColor greenColor];
// 自定义 placeholder 字体
_textView1.ba_placeholderFont = [UIFont systemFontOfSize:16];
[self.view addSubview:_textView1];
}
return _textView1;
}
- (UITextView *)textView
{
if (!_textView)
{
_textView = [[UITextView alloc] init];
_textView.userInteractionEnabled = YES;
/**
文字字体，注意：一定要用 ba_textFont 设置，用系统的 self.font 设置无效
*/
_textView.ba_textFont = [UIFont systemFontOfSize:13];
/**
文字颜色，注意：一定要用 ba_textColor 设置，用系统的 self.textColor 设置无效
*/
_textView.ba_textColor = [UIColor redColor];
_textView.backgroundColor = BAKit_Color_Gray_11;
// 自定义 placeholder
_textView.ba_placeholder = @"这里是 placeholder ！";
// 自定义 placeholder 颜色
_textView.ba_placeholderColor = [UIColor orangeColor];
// 自定义 placeholder 字体
_textView.ba_placeholderFont = [UIFont systemFontOfSize:25];
// 设置代理
[_textView ba_textViewWithDelegate:_textView];
/**
快速设定自动布局
@param maxHeight 最大高度
@param minHeight 最小高度
@param block BAKit_TextView_HeightDidChangedBlock
*/
BAKit_WeakSelf
[_textView ba_textView_autoLayoutWithMaxHeight:100 minHeight:60 block:^(CGFloat current_textViewHeight) {
BAKit_StrongSelf
self.textView_Height = current_textViewHeight;
[self.view setNeedsLayout];
}];
/**
快速设定最大字数限制返回当前字数
@param limitNumber 最大字数限制
@param block BAKit_TextView_WordDidChangedBlock
*/
[_textView ba_textView_wordLimitWithMaxWordLimitNumber:30 block:^(NSString *current_text) {
BAKit_StrongSelf
dispatch_async(dispatch_get_main_queue(), ^{
self.label3.text = [NSString stringWithFormat:@"%ld/%ld", (long)current_text.length, (long)self.textView.ba_maxWordLimitNumber];
[self.view setNeedsLayout];
});
}];
[self.view addSubview:self.textView];
}
return _textView;
}
其他示例可下载 demo 查看源码！
```
## 5、更新记录：【倒叙】
欢迎使用 [【BAHome】](https://github.com/BAHome) 系列开源代码 ！
如有更多需求，请前往：[【https://github.com/BAHome】](https://github.com/BAHome)
最新更新时间：2018-06-15 【倒叙】
最新Version：【Version：1.0.5】
更新内容：
1.0.5.1、修改BUG：感谢 群里同学（@深圳-Apec）提出 [Issues](https://github.com/BAHome/BATextView/is
最新更新时间：2018-06-14 【倒叙】
最新Version：【Version：1.0.4】
更新内容：
1.0.4.2、修改BUG：使用关联词造成的返回字数bug。现已修复该问题
1.0.4.1、修改BUG：感谢 Github同学提出 [Issues](https://github.com/BAHome/BATextView/issues/4) 调用ba_text赋值后和ba_placeholder颜色字体大小一样的BUG。现已修复该问题
最新更新时间：2017-11-15 【倒叙】
最新Version：【Version：1.0.3】
更新内容：
1.0.3.1、优化输入表情的时候，最大字数限制出现的特殊情况
1.0.3.2、优化输入文字后收回键盘后再次输入之前的内容消失的问题
1.0.3.3、【方法新增】：默认 self.text 文字时的属性 ba_text：TextView 默认 text，注意：一定要用 ba_text 设置，用系统的 self.text 设置无效，此外，如果有默认 text，一定要在 ba_placeholder 赋值之前赋值 ba_text，要不然会出现文字颜色错乱！感谢群里[@北京-张浩](https://github.com/907064772 )大神的优化！
1.0.3.4、【方法新增】：新增 UITextView 代理 shouldChangeTextInRange 改成 block （ba_textView_ShouldChangeTextInRangeBlock）返回，使用更加方便！
1.0.3.5、【方法替换】：原有 typedef void (^BAKit_TextView_WordDidChangedBlock)(NSInteger current_length)，替换成 typedef void (^BAKit_TextView_WordDidChangedBlock)(NSString *current_text)
最新更新时间：2017-09-19 【倒叙】
最新Version：【Version：1.0.2】
更新内容：
1.0.2.1、优化 - (BOOL)ba_textView_isEmpty; 方法，修复 输入文字和 placeholder 文字一样时判断无效的 bug(感谢群里 [@成都-刘军 11:52:23](https://github.com/liujunliuhong ) 同学提出的 bug！)
最新更新时间：2017-06-01 【倒叙】
最新Version：【Version：1.0.1】
更新内容：
1.0.1.1、优化注释
最新更新时间：2017-05-27 【倒叙】
最新Version：【Version：1.0.0】
更新内容：
1.0.0.1、可以自定义 placeholder的(字体、颜色)、文字(字体、颜色)
1.0.0.2、可以自定义 输入文字的(字体、颜色)、文字(字体、颜色)
1.0.0.3、可以自动布局，自适应高度，实时监测输入文字的最大高度
1.0.0.4、可以实时监测输入文字的最大个数，可以限制最大输入文字字数
1.0.0.5、用分类整理，无需改动源码即可实现各种自定义功能
## 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：363605775
git：[https://github.com/CrazyCoderShi](https://github.com/CrazyCoderShi)
简书：[http://www.jianshu.com/u/0726f4d689a3](http://www.jianshu.com/u/0726f4d689a3)
> 张浩
QQ：907064772
git：[https://github.com/907064772](https://github.com/907064772)
## 8、开发环境 和 支持版本
> 开发使用 最新版本 Xcode，理论上支持 iOS 9 及以上版本，如有版本适配问题，请及时反馈！多谢合作！
## 9、感谢
> 感谢 [【BAHome】](https://github.com/BAHome) 团队成员倾力合作，后期会推出一系列 常用 UI 控件的封装，大家有需求得也可以在 issue 提出，如果合理，我们会尽快推出新版本！
> [【BAHome】](https://github.com/BAHome) 的发展离不开小伙伴儿的信任与推广，再次感谢各位小伙伴儿的支持！