Latest 1.0.3
Homepage https://github.com/BAHome/BATextView
License MIT
Platforms ios 7.0, requires ARC
Authors

BAHome Team Name


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、图片示例

BATextView

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

4、BATextView 的类结构及 demo 示例

BATextView

UITextView+BAKit.h

#import <UIKit/UIKit.h>

/*! 过期属性或方法名提醒 */
#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)<UITextViewDelegate>

/**
 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 <UITextViewDelegate>)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

最新更新时间: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
简书:http://www.jianshu.com/u/95c9800fdf47
微博:

马景丽
QQ:1253540493
git:https://github.com/MaJingli

陆晓峰
QQ:442171865
git:https://github.com/zeR0Lu

陈集
QQ:3161182978
git:https://github.com/chenjipdc
简书:http://www.jianshu.com/u/90ae559fc21d

任子丰
QQ:459643690
git:https://github.com/renzifeng

吴丰收
QQ:498121294

石少庸
QQ:363605775
git:https://github.com/CrazyCoderShi
简书:http://www.jianshu.com/u/0726f4d689a3

8、开发环境 和 支持版本

开发使用 最新版本 Xcode,理论上支持 iOS 9 及以上版本,如有版本适配问题,请及时反馈!多谢合作!

9、感谢

感谢 【BAHome】 团队成员倾力合作,后期会推出一系列 常用 UI 控件的封装,大家有需求得也可以在 issue 提出,如果合理,我们会尽快推出新版本!

【BAHome】 的发展离不开小伙伴儿的信任与推广,再次感谢各位小伙伴儿的支持!

Latest podspec

{
    "name": "BATextView",
    "version": "1.0.3",
    "summary": "UITextView u7684u5c01u88c5uff0cu53efu4ee5u81eau5b9au4e49 placeholderu3001u6587u5b57u7684(u5b57u4f53u3001u989cu8272)u3001u6587u5b57(u5b57u4f53u3001u989cu8272)uff0cu81eau9002u5e94u9ad8u5ea6uff0cu5b9eu65f6u76d1u6d4bu8f93u5165u6587u5b57u7684u6700u5927u9ad8u5ea6uff0cu5b9eu65f6u76d1u6d4bu8f93u5165u6587u5b57u7684u6700u5927u4e2au6570uff0cu53efu4ee5u9650u5236u6700u5927u8f93u5165u6587u5b57u5b57u6570",
    "homepage": "https://github.com/BAHome/BATextView",
    "license": "MIT",
    "authors": {
        "boai": "[email protected]"
    },
    "platforms": {
        "ios": "7.0"
    },
    "source": {
        "git": "https://github.com/BAHome/BATextView.git",
        "tag": "1.0.3"
    },
    "source_files": "BATextView/BATextView/*.{h,m}",
    "requires_arc": true
}

Pin It on Pinterest

Share This