数字字段
数字字段（Number）用于存储数值，支持数字输入、评分、滑动条、进度条四种渲染形式。
概述
数字字段以双精度浮点（float8）存储，适用于数量、分数、比例等场景。通过数字渲染类型可以改变其采集与展示方式：
- 数字输入：标准数字输入框；
- 评分：星级评分；
- 滑动条：拖动滑块取值；
- 进度条：以进度条展示（只读展示）。
数字字段还可配置精度（小数位数）与取值范围。
配置项
| 配置项 | 说明 | 适用渲染类型 |
|---|---|---|
| 名称 | 字段显示名称，必填 | 全部 |
| 编码 | 字段唯一编码，必填，创建后不可修改 | 全部 |
| 描述 | 字段用途说明 | 全部 |
| 数字渲染类型 | 数字输入、评分、滑动条、进度条 | 全部 |
| 精度 | 小数位数，范围 0–6 | 全部 |
| 最小值 | 允许的最小数值 | 数字输入、滑动条、进度条 |
| 最大值 | 允许的最大数值 | 数字输入、滑动条、进度条 |
| 滑动步长 | 滑动条每次移动的步长 | 滑动条 |
| 输入框前缀 | 输入框左侧前缀文本 | 全部 |
| 输入框后缀 | 输入框右侧后缀文本 | 全部 |
数字渲染类型
| 渲染类型 | 值 | 说明 | 适用场景 |
|---|---|---|---|
| 数字输入 | 0 | 标准数字输入框 | 常规数值录入 |
| 评分 | 1 | 星级评分组件（支持半星） | 满意度、评分 |
| 滑动条 | 2 | 拖动滑块选择数值 | 范围调节、音量 |
| 进度条 | 3 | 以进度条展示数值（只读） | 进度、完成率 |
取值范围与步长
- 最小值 / 最大值：约束字段可接受的数值范围。
- 滑动步长：仅在滑动条模式下生效，控制滑块每次移动的最小增量。
- 当渲染类型为滑动条时，若未设置最小值/最大值，系统默认取
0与100。 - 当渲染类型为进度条时，必须同时设置最小值与最大值，否则保存时报错。
下一步
属性明细
以下内容面向技术实现与 AI 检索。
数字字段属性表
| 属性名 | 类型 | 含义 | 取值/存储值 |
|---|---|---|---|
FieldType | int | 字段类型 | Number = 9 |
NumericFieldRenderType | NumericFieldRenderTypeEnum | 数字渲染类型 | Number=0 / Rate=1 / Slider=2 / Progress=3 |
Precision | int | 小数位数 | 0–6 |
Properties.NubmerMinValue | int? | 最小值 | 滑动条默认 0 |
Properties.NubmerMaxValue | int? | 最大值 | 滑动条默认 100 |
Properties.NumberSlideInputStep | double? | 滑动步长 | 仅滑动条模式 |
Properties.Prefix | string | 输入框前缀 | 可空 |
Properties.Suffix | string | 输入框后缀 | 可空 |
属性名中的
Nubmer为系统既有拼写，请以代码为准，勿写成Number。
数字渲染类型枚举值
| 枚举名 | 值 | 中文含义 |
|---|---|---|
Number | 0 | 数字输入框 |
Rate | 1 | 评分 |
Slider | 2 | 滑动输入框 |
Progress | 3 | 进度条 |
存储示例
字段定义：
{
"Code": "score",
"Name": "评分",
"FieldType": 9,
"NumericFieldRenderType": 1,
"Precision": 1,
"Properties": {
"NubmerMinValue": 0,
"NubmerMaxValue": 5
}
}
对象数据中的存储值：
{
"Fields": {
"score": { "Code": "score", "Text": "4.5", "Value": 4.5 }
}
}