输入类控件
目录
单行文本 (input)
基本信息
| 属性 |
值 |
| jnpfKey |
input |
| AIBridge builder |
build_field_model(..., jnpf_key="input") |
| 源码示例 |
extend/formDemo/fieldForm1/index.vue |
| workSystem 示例 |
几乎所有表单 |
基本规则
-
必填配置:
field_name: 字段中文名称 (显示在表单标签)
field_vmodel: 字段 vModel 值 (对应数据库字段)
jnpf_key: 必须为 "input"
-
常用配置:
required: 是否必填 (默认 False)
placeholder: 占位提示文本
showPassword: 是否显示密码格式 (默认 False)
prefixIcon: 输入框前缀图标
suffixIcon: 输入框后缀图标
AIBridge 使用
workSystem 示例
| 表单名称 |
表单ID |
用途说明 |
| 信贷信息 |
797473600809468485 |
基本信息输入 |
| 员工培训 |
624164673918337925 |
多字段表单 |
| 产品管理 |
469039386000943493 |
产品名称、编码输入 |
常见错误
| 错误现象 |
原因 |
解决 |
| 输入内容不保存 |
vModel 与数据库字段不匹配 |
确保 field_vmodel 与表字段名一致 (大写 F_ 前缀) |
| 必填校验不生效 |
required 未设置为 True |
build_field_model(..., required=True) |
| placeholder 不显示 |
平台自动生成 |
如需自定义,可通过 __config__.placeholder 设置 |
多行文本 (textarea)
基本信息
| 属性 |
值 |
| jnpfKey |
textarea |
| AIBridge builder |
build_field_model(..., jnpf_key="textarea") |
| 源码示例 |
extend/formDemo/fieldForm1/index.vue |
| workSystem 示例 |
员工培训、离职申请、采购申请 等 |
基本规则
- 必填配置:同 input
- 特有配置:
rows: 显示行数 (默认 4)
maxlength: 最大输入字符数 (默认无限制)
AIBridge 使用
workSystem 示例
| 表单名称 |
表单ID |
配置 |
| 员工培训 |
624164673918337925 |
textarea, required |
| 离职申请 |
623163301152424133 |
textarea |
| 离职交接表 |
623417538411233285 |
textarea, 较长内容 |
| 产品管理 |
469039386000943493 |
产品描述 |
数字输入 (inputNumber)
基本信息
| 属性 |
值 |
| jnpfKey |
inputNumber / numInput |
| AIBridge builder |
build_field_model(..., jnpf_key="inputNumber") |
| 源码示例 |
extend/formDemo/fieldForm1/index.vue |
| workSystem 示例 |
信贷信息、油耗计算、订单明细 等 |
基本规则
- 必填配置:同 input
- 特有配置:
step: 步进值 (默认 1)
controls: 是否显示增减按钮 (默认 True)
min: 最小值 (默认无限制)
max: 最大值 (默认无限制)
AIBridge 使用
workSystem 示例
| 表单名称 |
表单ID |
配置 |
| 信贷信息 |
797473600809468485 |
贷款金额 |
| 油耗计算 |
797460178185224773 |
油耗数量计算 |
| 报价信息 |
585107422926864709 |
价格输入 |
| 订单示例 |
469133201755925637 |
订单数量、单价 |
金额输入特殊处理
金额类字段通常需要:
- 设置
step=0.01 或 step=1
- 设置适当的
min (通常为 0)
- 可配合
addonAfter 显示单位 (如 "元")
输入类控件通用配置
AIBridge build_field_model 完整参数
| 参数 |
类型 |
默认值 |
说明 |
| field_name |
str |
必填 |
字段中文名称 |
| field_vmodel |
str |
必填 |
字段 vModel (对应数据库) |
| jnpf_key |
str |
"input" |
控件类型 |
| required |
bool |
False |
是否必填 |
| table_name |
str |
"base_table" |
表名 |
| render_key |
int |
0 |
渲染 key |
| options |
list |
None |
下拉选项 (select/radio/checkbox 用) |
| dictionary_type |
str |
"" |
数据字典类型 |
输出结构
数据存储规律
输入类控件存储规律
| 控件 |
jnpfKey |
存储类型 |
示例 |
| 单行文本 |
input |
字符串 |
"测试文本ABC123" |
| 多行文本 |
textarea |
字符串(含换行符) |
"第一行\n第二行\n第三行" |
| 数字输入 |
inputNumber |
数值或字符串(取决于 precision 配置) |
12345.67 或 "12345.67" |
实际测试结果
通过 AIBridge API 实际测试结果:
数据库字段要求
| 控件 |
建议字段类型 |
| input |
varchar(500) 或 text |
| textarea |
text |
| inputNumber |
decimal(18,2) 或 varchar(50) |
下一步