数字框

1. 组件概述

数字框是一个数据输入组件，专门用于输入数值。与普通文本框不同，数字框只接受数字输入，并提供加减按钮、步长控制、精度设置、范围限制等功能，让数值输入更加便捷和准确。适用于需要输入价格、数量、年龄、分数等数字的场景。

加载中...

查看 JSON

复制 JSON

2. 应用场景示例

• 场景一：AI 参数调节。在调用 AI 模型时，用户需要设置温度（temperature）、最大输出长度等参数。使用数字框设置最小值为 0、最大值为 1、小数位数为 2，让用户通过加减按钮或直接输入来精确调节参数值。
• 场景二：答题计分器。在知识问答类应用中，需要记录用户的得分。使用数字框设置最小值为 0、步长为 10，开启千分符方便查看大数值，用户可以快速调整分数。

加载中...

查看 JSON

复制 JSON

3. 功能配置

高级

基本折叠组

配置项	说明
绑定变量	组件的变量名，用户输入的数值会以此变量名存储。其他组件可以绑定此变量来显示其值，调用工作流时此变量的值也会传递给工作流。
标题	数字框左侧显示的标签文字，用于说明该输入项的用途，如”价格”、“数量”、“年龄”等。
千分符	开启后，数字会以千分位格式显示（如 1,234,567），方便阅读大数值。适用于金额、人口数量等较大数字的输入场景。
默认值	数字框的初始值。可以设置为静态数值或绑定变量。
最小值	限制用户输入的最小数值。当用户输入或通过加减按钮调整到小于此值时，会自动修正为最小值。可以设置为静态数值或绑定变量。
最大值	限制用户输入的最大数值。当用户输入或通过加减按钮调整到大于此值时，会自动修正为最大值。可以设置为静态数值或绑定变量。
显示加减按钮	开启后，数字框旁边会显示加减按钮，用户可以点击按钮来增减数值，而不必手动输入。默认开启。
方向键加减	开启后，用户可以通过键盘的上下方向键来增减数值。默认开启，方便键盘操作。
加减步长	每次点击加减按钮或按方向键时，数值增减的幅度。例如设置为 10，则每次点击加号数值增加 10。默认为 1。仅在开启”显示加减按钮”时显示此配置。
小数位数	控制数值保留的小数位数，系统会根据四舍五入规则自动处理。例如设置为 2，则 3.1415 会显示为 3.14。适用于需要精确控制小数精度的场景，如价格、百分比等。
前缀	显示在数字前面的文字，如”¥”、”$“等货币符号。前缀仅用于显示，不会影响实际存储的数值。
后缀	显示在数字后面的文字，如”元”、“个”、”%“等单位。后缀仅用于显示，不会影响实际存储的数值。
单位选项	为数字框添加可选的单位下拉菜单。当配置多个单位选项时，用户可以从下拉菜单中选择单位（如”元”、“万元”）；当只配置一个单位时，会直接显示该单位文字。选择的单位会附加到数值后面一起存储。
标题提示	在标题旁边显示一个小问号图标，鼠标悬停时弹出提示内容。适合放置简短的帮助说明。
控件提示	在输入框旁边显示一个小问号图标，鼠标悬停时弹出提示内容。
占位提示	输入框为空时显示的灰色提示文字，引导用户输入。如”请输入数量”。用户开始输入后，占位提示会消失。
描述	显示在数字框下方的浅色说明文字，用于补充解释该配置项的用途或填写要求。

状态折叠组

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

校验折叠组

配置项	说明
校验规则	配置数字框的校验规则，如必填、最大值、最小值等。当用户输入不符合规则时，会显示错误提示。

设计

基本折叠组

配置项	说明
快捷编辑	设置加减按钮的显示位置。“单侧按钮”将加减按钮放在输入框右侧（默认）；“两侧按钮”将减号放在左侧、加号放在右侧，视觉上更加对称。

事件

配置项	说明
添加事件	支持”值变化”、“获取焦点”、“失去焦点”三种触发事件。“值变化”事件在用户修改数值后触发，常用于根据输入值动态更新其他内容；“获取焦点”和”失去焦点”事件可用于输入提示或数据校验。