文本框

1. 组件概述

文本框是一个数据输入组件，用于收集用户输入的单行文本内容。它是最基础的表单输入组件，支持多种输入类型（普通文本、密码、邮箱、URL），可以配置前后缀、占位提示、字数限制等。文本框适用于需要用户输入简短文字的场景，如用户名、标题、关键词等。

加载中...

查看 JSON

复制 JSON

2. 应用场景示例

• 场景一：AI 问答输入。在智能答疑应用中，用户通过文本框输入问题，点击发送按钮后触发工作流调用 AI 生成回答。设置「绑定变量」为 question，配置「占位提示」为”请输入你的问题”，开启「可清除」方便用户重新输入。
• 场景二：用户信息收集。在学习档案页面中，使用文本框收集学生姓名。设置「标题」为”姓名”，开启「计数器」并设置「最大字数」为 20，帮助用户了解输入限制。

加载中...

查看 JSON

复制 JSON

3. 功能配置

基础

配置折叠组

配置项	说明
绑定变量	组件的变量名，是文本框最核心的配置。用户输入的内容会以此变量名存储，其他组件可以绑定此变量来显示其值，调用工作流时此变量的值也会传递给工作流。
标题	文本框左侧显示的标签文字，用于说明该输入项的用途，如”用户名”、“搜索关键词”。
输入类型	选择文本框的输入模式。可选：文本（普通文本输入）、密码（输入内容显示为圆点，适用于密码输入）、邮箱（自动校验邮箱格式）、URL（自动校验网址格式）。
可清除	开启后，输入框右侧显示清除按钮，点击可一键清空已输入的内容。
计数器	开启后，在输入框右侧显示已输入的字数。如果设置了「最大字数」，会同时显示字数上限，如”5/20”。仅在输入类型为”文本”或”密码”时可用。
最大字数	限制用户最多可输入的字符数量。超过限制后无法继续输入。建议配合「计数器」使用，让用户清楚了解输入限制。
AddOn	在输入框左侧或右侧添加附加内容。开启后可配置：类型（文本、按钮、提交按钮）、位置（左侧或右侧）、显示文字。常用于添加搜索按钮或单位标识（如”元”、“kg”）。
标题提示	在标题旁边显示一个小问号图标，鼠标悬停时弹出提示内容。适合放置简短的帮助说明。
控件提示	在输入框旁边显示一个小问号图标，鼠标悬停时弹出提示内容。
占位提示	输入框为空时显示的灰色提示文字，引导用户输入。如”请输入用户名”。用户开始输入后，占位提示会消失。
描述	显示在文本框下方的浅色说明文字，用于补充解释该输入项的用途或填写要求。

事件折叠组

配置项	说明
添加事件	支持”值变化”、“获取焦点”、“失去焦点”三种触发事件。“值变化”事件在用户每次输入内容时触发，可用于实时搜索或输入校验；“失去焦点”事件在用户点击输入框外部时触发，适合在用户完成输入后执行操作。

高级

选项折叠组

此折叠组仅在输入类型为”文本”且配置了选项数据时显示。

配置项	说明
选项	为文本框配置预设选项，用户输入时会显示匹配的选项供选择。适用于有固定候选值但也允许自由输入的场景。
多选	开启后，用户可以选择或输入多个值，每个值以标签形式显示在输入框内。
自动补全	根据用户输入的内容，调用接口动态获取匹配的选项。适用于选项数据量大或需要实时查询的场景，如搜索建议。

状态折叠组

配置项	说明
可见	控制文本框是否显示。默认可见，可以设置为始终隐藏或根据条件动态控制。
隐藏	控制文本框是否隐藏。与「可见」相反。
禁用	控制文本框是否禁用（变灰且不可输入）。可以设置为始终禁用或根据条件动态控制。
只读	开启后，文本框内容可见但不可编辑。适用于展示已有数据但不允许修改的场景。
静态展示	开启后，文本框变为只读的纯文本展示模式，不显示输入框边框。适用于详情页或确认页面。

校验折叠组

配置项	说明
校验规则	配置文本框的输入校验规则。根据输入类型不同，可用的校验规则也不同。常见规则包括：必填、最小长度、最大长度、正则表达式等。邮箱类型会自动添加邮箱格式校验，URL 类型会自动添加网址格式校验。