HPGrowingTextView 技术文档

1. 安装指南

1.1 使用 CocoaPods 安装

如果你使用 CocoaPods 来管理依赖，可以在 Podfile 中添加以下内容：

pod 'HPGrowingTextView'

然后运行以下命令来安装：

pod install

1.2 手动安装

1. 下载 HPGrowingTextView 项目源码。
2. 将 HPGrowingTextView.h 和 HPGrowingTextView.m 文件拖入你的 Xcode 项目中。
3. 确保在项目设置中添加了 UIKit 框架。

2. 项目的使用说明

HPGrowingTextView 是一个多行/自动调整大小的 UITextView，类似于短信应用中的输入框。它允许你设置最大和最小行数，以及最大和最小高度。通过这些属性，你可以控制文本视图的自动增长行为。

2.1 基本使用

在你的视图控制器中，导入 HPGrowingTextView 头文件：

#import "HPGrowingTextView.h"

然后，在你的视图控制器中创建并配置 HPGrowingTextView：

HPGrowingTextView *textView = [[HPGrowingTextView alloc] initWithFrame:CGRectMake(10, 10, 300, 40)];
textView.minNumberOfLines = 1;
textView.maxNumberOfLines = 6;
textView.animateHeightChange = YES;
textView.animationDuration = 0.2;
textView.delegate = self;
[self.view addSubview:textView];

2.2 属性设置

• maxNumberOfLines：文本视图停止增长时的最大行数。
• minNumberOfLines：文本视图开始增长时的最小行数。
• maxHeight：指定文本视图的最大高度（以点为单位）。
• minHeight：指定文本视图的最小高度（以点为单位）。
• animateHeightChange：是否在高度变化时使用动画。
• animationDuration：调整高度变化动画的持续时间。

2.3 代理方法

你可以通过实现 HPGrowingTextViewDelegate 协议中的方法来处理文本视图的各种事件：

#pragma mark - HPGrowingTextViewDelegate

- (BOOL)growingTextViewShouldBeginEditing:(HPGrowingTextView *)growingTextView {
    // 处理文本视图即将开始编辑的事件
    return YES;
}

- (void)growingTextViewDidChange:(HPGrowingTextView *)growingTextView {
    // 处理文本视图内容变化的事件
}

- (void)growingTextView:(HPGrowingTextView *)growingTextView didChangeHeight:(float)height {
    // 处理文本视图高度变化后的事件
}

3. 项目API使用文档

3.1 属性

• maxNumberOfLines：int 类型，设置文本视图的最大行数。
• minNumberOfLines：int 类型，设置文本视图的最小行数。
• maxHeight：int 类型，设置文本视图的最大高度（以点为单位）。
• minHeight：int 类型，设置文本视图的最小高度（以点为单位）。
• animateHeightChange：BOOL 类型，设置是否在高度变化时使用动画。
• animationDuration：NSTimeInterval 类型，设置高度变化动画的持续时间。

3.2 代理方法

• -(BOOL)growingTextViewShouldBeginEditing:(HPGrowingTextView *)growingTextView;：文本视图即将开始编辑时调用。
• -(BOOL)growingTextViewShouldEndEditing:(HPGrowingTextView *)growingTextView;：文本视图即将结束编辑时调用。
• -(void)growingTextViewDidBeginEditing:(HPGrowingTextView *)growingTextView;：文本视图开始编辑时调用。
• -(void)growingTextViewDidEndEditing:(HPGrowingTextView *)growingTextView;：文本视图结束编辑时调用。
• -(BOOL)growingTextView:(HPGrowingTextView *)growingTextView shouldChangeTextInRange:(NSRange)range replacementText:(NSString *)text;：文本视图内容即将变化时调用。
• -(void)growingTextViewDidChange:(HPGrowingTextView *)growingTextView;：文本视图内容变化时调用。
• -(void)growingTextView:(HPGrowingTextView *)growingTextView willChangeHeight:(float)height;：文本视图高度即将变化时调用（动画过程中）。
• -(void)growingTextView:(HPGrowingTextView *)growingTextView didChangeHeight:(float)height;：文本视图高度变化后调用。
• -(void)growingTextViewDidChangeSelection:(HPGrowingTextView *)growingTextView;：文本视图选择区域变化时调用。
• -(BOOL)growingTextViewShouldReturn:(HPGrowingTextView *)growingTextView;：文本视图按下返回键时调用。

4. 项目安装方式

4.1 使用 CocoaPods

在 Podfile 中添加：

pod 'HPGrowingTextView'

然后运行：

pod install

4.2 手动安装

1. 下载项目源码。
2. 将 HPGrowingTextView.h 和 HPGrowingTextView.m 文件添加到你的项目中。
3. 确保项目中包含 UIKit 框架。