多行文本框

1. 组件概述

多行文本框是一个数据输入组件，用于输入较长的、可能包含换行的文本内容。与单行文本框不同，多行文本框可以显示多行文字，并支持用户按回车键换行。它适用于需要输入备注、描述、评论、问题详情等长文本的场景，是收集用户详细输入的常用组件。

加载中...

查看 JSON

复制 JSON

2. 应用场景示例

• 场景一：AI 问答输入。在智能答疑应用中，学生需要输入完整的问题描述，可能包含多行内容。使用多行文本框让学生详细描述问题，设置合适的占位提示如”请详细描述你的问题…”，开启计数器和最大字数限制，避免输入过长。
• 场景二：作文批改提交。在写作辅导应用中，学生需要提交整篇作文让 AI 进行批改。使用多行文本框作为作文输入区域，设置较大的最小展示行数（如 10 行），让输入区域足够宽敞，方便学生粘贴或输入完整文章。

加载中...

查看 JSON

复制 JSON

3. 功能配置

基础

配置折叠组

配置项	说明
绑定变量	组件的变量名，用户输入的文本内容会存储到这个变量中。其他组件可以绑定此变量来显示其值，调用工作流时此变量的值也会传递给工作流。
标题	显示在输入框左侧或上方的标签文字，用于说明该输入项的用途，如”问题描述”、“详细内容”。
默认值	输入框的初始内容。可以设置为静态文本或绑定变量。适用于需要预填内容的场景，如提供输入模板。
去除首尾空白	开启后，用户输入的内容会自动去除开头和结尾的空格。默认开启，可以避免用户不小心输入多余空格导致的数据问题。
计数器	开启后，在输入框下方显示已输入的字数。如果同时设置了最大字数，会显示为”已输入/最大”的格式，帮助用户了解输入进度。
最大字数	限制用户最多可以输入的字符数量。超过限制后无法继续输入。适用于需要控制内容长度的场景，如限制问题描述不超过 500 字。
标题提示	在标题旁边显示一个小问号图标，鼠标悬停时弹出提示内容。适合放置简短的帮助说明，如”请用简洁的语言描述你的问题”。
控件提示	在输入框旁边显示一个小问号图标，鼠标悬停时弹出提示内容。注意：需要设置控件宽度，否则图标可能换行。
占位提示	输入框为空时显示的灰色提示文字，引导用户输入。如”请输入详细描述…”。用户开始输入后，占位提示会消失。
描述	显示在输入框下方的浅色说明文字，用于补充解释该输入项的用途或填写要求。

事件折叠组

配置项	说明
添加事件	支持”值变化”、“获取焦点”、“失去焦点”三种触发事件。“值变化”事件在用户每次输入内容时触发，可用于实时字数统计或内容预览；“失去焦点”事件适合在用户完成输入后触发工作流进行内容处理。

设计

表单项折叠组

配置项	说明
最小展示行数	输入框最少显示的行数，决定了输入框的最小高度。默认为 3 行。如果预期用户会输入较长内容，可以设置更大的值（如 5-10 行），让输入区域更宽敞。
最大展示行数	输入框最多显示的行数，决定了输入框的最大高度。默认为 20 行。当内容超过最大行数时，输入框会出现滚动条。设置合理的最大行数可以避免输入框过度撑开页面。

高级

状态折叠组

配置项	说明
可见	控制组件是否显示。默认可见。
隐藏	控制组件是否隐藏。与”可见”相反。
禁用	控制组件是否禁用（变灰且不可操作）。可以设置为始终禁用，或根据条件动态控制。
只读	开启后，输入框变为只读状态，用户可以查看内容但无法编辑。适用于展示已提交内容的场景。
静态展示	开启后，组件变为纯文本展示模式，不显示输入框样式。适用于详情页或确认页面。
隐藏时删除字段	开启后，当该组件被隐藏时，其值会从表单数据中删除。适用于条件显示的字段，避免提交无关数据。

校验折叠组

配置项	说明
必填	开启后，该字段必须填写才能提交表单。适用于问题描述、反馈内容等必须填写的场景。
最大长度	校验输入内容的最大字符数。与”最大字数”配置不同，这里是提交时的校验规则，超过会提示错误。
最小长度	校验输入内容的最小字符数。适用于要求用户至少输入一定内容的场景，如”问题描述至少 10 个字”。