数字字段用于保存一个数值。它可以控制范围、精度、仅整数规则、展示前缀或后缀，以及校验提示。
金额、数量、比例、评分、时长，或任何需要按数字筛选和统计的字段，都适合使用数字字段。
基础配置
| 配置项 | 说明 |
|---|
| 名称 | 展示给用户的字段标签，必填；名称应清楚表达这个数值的业务含义 |
| API 名称 | 数据接口、脚本、公式、导入和集成使用的稳定技术名称，必填 |
| 必填 | 保存记录前必须填写数值 |
| 只读 | 展示数值，但不允许用户编辑 |
| 停用 | 字段不参与常规使用 |
| 隐藏 | 字段会保存数值，但不在常规表单页面展示 |
数字字段配置
| 配置项 | 说明 |
|---|
| 占位提示 | 用户输入数字前显示在字段中的提示文案 |
| 最小值 | 允许提交的最小数值 |
| 最大值 | 允许提交的最大数值 |
| 步长 | 数字输入控件每次增加或减少的值 |
| 精度 | 数字保留的小数位数；留空时由系统自动处理 |
| 前缀 | 展示在数字前面的文本，例如货币符号 |
| 后缀 | 展示在数字后面的文本，例如单位或百分号 |
| 最小值提示 | 数值小于最小值时显示的自定义提示 |
| 最大值提示 | 数值大于最大值时显示的自定义提示 |
| 倍数规则 | 要求数值必须是指定数字的倍数 |
| 倍数规则提示 | 不满足倍数规则时显示的自定义提示 |
| 仅整数提示 | 不满足仅整数校验时显示的自定义提示 |
| 校验时机 | 控制什么时候执行校验：值变更时、失焦时或提交记录时 |
| 输入状态 | 给输入框添加警告或错误等视觉状态 |
| 仅整数 | 只允许录入整数 |
| 显示控制器 | 显示数字输入框中的加减控制器 |
| 颜色 | 设置字段展示颜色 |
| 帮助文案 | 展示在字段附近的辅助说明；可用于说明单位、范围或精度规则 |
常见示例
| 场景 | 建议配置 |
|---|
| 金额 | 前缀 $，精度 2，最小值 0 |
| 数量 | 开启仅整数，最小值 0，步长 1 |
| 百分比 | 后缀 %，最小值 0，最大值 100，精度 2 |
| 评分 | 最小值 1，最大值 5，步长 1 |
配置建议
| 建议 | 说明 |
|---|
| 同时设置最小值和最大值 | 范围限制能让校验更明确，避免异常数值 |
| 用后缀说明单位 | 例如 kg、小时、%，让用户知道数字含义 |
| 金额和比例设置精度 | 固定精度可以保持展示一致 |
| 计数类字段开启仅整数 | 数量、次数、序号类值通常不应接受小数 |