# 变更记录
| 产品版本 | 更新内容 | 更新日期 |
| --- | --- | --- |
| V7.0.1 | 更新了多行文本"内容更新时滚动至最底"属性，满足过程信息的自动刷新及最新展示 | 2024-10-24 |
# 1 功能介绍
用于输入多行文本，回车可换行。结合 *字段布局面板 *控件使用，布局体验最佳。
# 2 控件对象
`kd.bos.form.field.TextAreaEdit`
# 3 视觉展示
# 4 属性说明
## 4.1 通用属性
>通用属性包含字段和控件的一些公有的属性，如宽高，帮助文本等。请参考[通用属性](https://vip.kingdee.com/article/215559076720798976)
## 4.2 样式属性
>样式属性是每个控件在设计器右侧样式栏可以设置的属性，请参考[样式属性](https://vip.kingdee.com/article/252017936767406336)
## 4.3 业务属性
| 属性名 | 类型 | 默认值 | 说明 |
| --- | --- | --- | --- |
| 最大长度 | 整数 | 255 | 字段允许输入的最大长度范围，超出输入无效 |
| 最小长度 | 整数 | 0 | 字段允许输入的最小长度范围 |
| 编辑风格 | 下拉 | 文本框编辑 | 设置文本类型字段的编辑风格，showEditButton设置是否显示编辑按钮；详情见4.3.1 |
| 按钮图标 | 弹框选择 | - | 在文本类型字段为按钮编辑风格时，可以设置按钮的图标 |
| 为空提示信息 | 文本 | - | 当字段内容为空时，输入框内显示的信息 |
| 锁定为空提示信息 | 文本 | - | 当字段内容为空且字段锁定时显示的信息，锁定为空信息会覆盖为空提示信息 |
### 4.3.1 编辑风格
**编辑风格**属性三个选项，默认是文本编辑。选择**按钮编辑**或者**按钮+文本编辑**后，出现按钮图标属性。跟随按钮图标可修改。 点击按钮，发送click事件到服务端插件，服务端通过监听click事件对文本进行处理。
*注意：*
*1.选择按钮编辑时，文本框不可输入，只能通过服务端返回值来修改*
*2.选择按钮+文本编辑模式时，文本框既可以输入，也可以通过服务端来修改*
### 4.3.2 滚动至最底
v7.0版本，单头多行文本字段新增`scrollToBottom`属性，允许在进行赋值的同时，将内容滚动到最底部，满足过程信息的自动刷新以及最新内容的展示。
插件代码示例：
```
plugin.onAfterCreatNewData(event => {
let metadata = new HashMap<string, boolean>()
metadata.put('scrollToBottom', true)
plugin.getView().updateControlMetadata('kdtest_textareafield', metadata)
})
```
结果展示：
# 5 多行文本接口介绍
## 5.1 控件编程模型
多行文本字段，派生自文本字段，采用与文本字段相同的控件编程模型TextEdit。
## 5.2 数据模型
多行文本字段的属性对象类型为TextAreaProp，派生自文本字段属性对象类型TextProp，存储String类型字段值：
```java
package kd.bos.entity.property;
public class TextAreaProp extends TextProp {
```
请参阅[文本字段数据模型](https://vip.kingdee.com/article/228981705241898752)，了解如何存取字段值。
## 5.3 插件事件
多行文本字段，继承了字段值改变事件，未增加其他插件事件。
