# 特殊控件 ## 目录 - [开关 (switch)](#开关-switch) - [评分 (rate)](#评分-rate) - [颜色选择 (colorPicker)](#颜色选择-colorpicker) - [签章 (sign)](#签章-sign) - [二维码 (qrcode)](#二维码-qrcode) - [分隔线 (divider)](#分隔线-divider) - [分组标题 (groupTitle)](#分组标题-grouptitle) - [页签 (tab)](#页签-tab) - [轮播 (carousel)](#轮播-carousel) - [单据规则 (billRule)](#单据规则-billrule) - [计算 (calculate)](#计算-calculate) - [自动完成 (autoComplete)](#自动完成-autocomplete) --- ## 开关 (switch) ### 基本信息 | 属性 | 值 | |------|-----| | jnpfKey | `switch` | | AIBridge builder | `build_field_model(..., jnpf_key="switch")` | ### 基本规则 | 配置 | 类型 | 默认值 | 说明 | |------|------|--------|------| | activeValue | any | true | 开启时的值 | | inactiveValue | any | false | 关闭时的值 | ### AIBridge 使用 ```python field = build_field_model( field_name="是否启用", field_vmodel="f_enabled", jnpf_key="switch" ) # 自定义值 field = build_field_model( field_name="接收通知", field_vmodel="f_receive_notification", jnpf_key="switch", activeValue="1", inactiveValue="0" ) ``` --- ## 评分 (rate) ### 基本信息 | 属性 | 值 | |------|-----| | jnpfKey | `rate` | | AIBridge builder | `build_field_model(..., jnpf_key="rate")` | ### 基本规则 | 配置 | 类型 | 默认值 | 说明 | |------|------|--------|------| | max | int | 5 | 最大分值 | | allowHalf | bool | false | 是否允许半星 | | showText | bool | false | 是否显示文字 | ### AIBridge 使用 ```python field = build_field_model( field_name="满意度评分", field_vmodel="f_satisfaction", jnpf_key="rate", max=5, allowHalf=True ) # 显示文字 field = build_field_model( field_name="等级评定", field_vmodel="f_level", jnpf_key="rate", max=3, showText=True ) ``` --- ## 颜色选择 (colorPicker) ### 基本信息 | 属性 | 值 | |------|-----| | jnpfKey | `colorPicker` | | AIBridge builder | `build_field_model(..., jnpf_key="colorPicker")` | ### AIBridge 使用 ```python field = build_field_model( field_name="主题颜色", field_vmodel="f_theme_color", jnpf_key="colorPicker" ) ``` --- ## 签章 (sign) ### 基本信息 | 属性 | 值 | |------|-----| | jnpfKey | `sign` | | AIBridge builder | 无封装 | | workSystem 示例 | 套打示例 (#24) | ### 基本规则 签章控件用于电子签章/盖章,**通常需配合流程使用**。 ### workSystem 示例 | 表单名称 | 表单ID | 说明 | |----------|--------|------| | 套打示例 | 585384793399624261 | billRule + sign, 单据签章 | --- ## 二维码 (qrcode) ### 基本信息 | 属性 | 值 | |------|-----| | jnpfKey | `qrcode` | | AIBridge builder | 无封装 | | workSystem 示例 | 二维码、条形码多组件值联动展示 (#3) | ### 基本规则 二维码控件用于生成和扫描二维码。 ### workSystem 示例 | 表单名称 | 表单ID | 说明 | |----------|--------|------| | 二维码、条形码多组件值联动展示 | 797444600007492165 | qrcode + inputNumber 联动 | ### 源码位置 ``` jnpf/移动端/jnpf-app-vue3/components/Jnpf/Qrcode/index.vue jnpf/移动端/jnpf-app-vue3/components/Jnpf/Barcode/index.vue ``` --- ## 分隔线 (divider) ### 基本信息 | 属性 | 值 | |------|-----| | jnpfKey | `divider` | | AIBridge builder | 无封装 | | workSystem 示例 | 入职申请、物资申请、套打示例 等 | ### workSystem 示例 | 表单名称 | 表单ID | 说明 | |----------|--------|------| | 入职申请 | 624163990351643525 | 表单分区 | | 物资申请 | 585436888639210245 | 类型分隔 | | 套打示例 | 585384793399624261 | 区域分隔 | ### 手动配置示例 ```json { "__config__": { "jnpfKey": "divider", "label": "基本信息" }, "orientation": "left", "contentPosition": "left" } ``` --- ## 分组标题 (groupTitle) ### 基本信息 | 属性 | 值 | |------|-----| | jnpfKey | `groupTitle` | | AIBridge builder | 无封装 | | workSystem 示例 | 离职交接表、预算管理、出差管理、事件管理 等 | ### workSystem 示例 | 表单名称 | 表单ID | 说明 | |----------|--------|------| | 离职交接表 | 623417538411233285 | 分组显示 | | 预算管理 | 469100392253286789 | 预算信息分组 | | 出差管理 | 469066996185622917 | 出差信息分组 | | 事件管理 | 469065268790880645 | 事件信息分组 | | 设备巡检管理 | 469062048563652997 | 巡检信息分组 | | 产品管理 | 469039386000943493 | 产品信息分组 | | 核酸检测 | 469038006062344581 | 检测信息分组 | | 药房管理 | 468849844170057541 | 药房信息分组 | | 报名管理外链 | 468848215723140933 | 报名信息分组 | | 用车管理 | 469040281883306373 | 用车信息分组 | | 人才管理 | 469047177461688709 | 人才信息分组 | ### 手动配置示例 ```json { "__config__": { "jnpfKey": "groupTitle", "label": "基本信息" }, "showBorder": true } ``` --- ## 页签 (tab) ### 基本信息 | 属性 | 值 | |------|-----| | jnpfKey | `tab` | | AIBridge builder | 无封装 | | workSystem 示例 | 高级控件和默认查询 (#34)、订单示例 (#43) | ### workSystem 示例 | 表单名称 | 表单ID | 说明 | |----------|--------|------| | 高级控件和默认查询 | 469499301635095045 | tab + table | | 订单示例 | 469133201755925637 | tab 切换明细 | --- ## 轮播 (carousel) ### 基本信息 | 属性 | 值 | |------|-----| | jnpfKey | `carousel` | | AIBridge builder | 无封装 | | workSystem 示例 | 表单规则 (#7) | ### workSystem 示例 | 表单名称 | 表单ID | 说明 | |----------|--------|------| | 表单规则 | 797378890455581253 | carousel + input + inputNumber + select | --- ## 单据规则 (billRule) ### 基本信息 | 属性 | 值 | |------|-----| | jnpfKey | `billRule` | | AIBridge builder | 无封装 | | workSystem 示例 | 套打示例、采购合同、订单示例、产品管理 等 | ### 基本规则 单据规则用于自动生成单据编号,通常是只读字段。 ### workSystem 示例 | 表单名称 | 表单ID | 说明 | |----------|--------|------| | 套打示例 | 585384793399624261 | 单据编号 | | 采购合同 | 585077579715707205 | 合同编号 | | 订单示例 | 469133201755925637 | 订单编号 | | 采购管理 | 469106304141552773 | 采购单号 | | 客户管理 | 469102214628043141 | 客户编号 | | 产品管理 | 469039386000943493 | 产品编码 | | 核酸检测 | 469038006062344581 | 检测编号 | | 药房管理 | 468849844170057541 | 药方编号 | | 应收费用 | 468826463014018501 | 应收单号 | | 用车管理 | 469040281883306373 | 用车单号 | --- ## 计算 (calculate) ### 基本信息 | 属性 | 值 | |------|-----| | jnpfKey | `calculate` | | AIBridge builder | 无封装 | | workSystem 示例 | 水电费用 (#25)、采购合同 (#28) | ### workSystem 示例 | 表单名称 | 表单ID | 说明 | |----------|--------|------| | 水电费用 | 585110234985398597 | calculate + table, 自动计算费用 | | 采购合同 | 585077579715707205 | calculate, 金额汇总计算 | --- ## 自动完成 (autoComplete) ### 基本信息 | 属性 | 值 | |------|-----| | jnpfKey | `autoComplete` | | AIBridge builder | 无封装 | | workSystem 示例 | 数据接口调用字段示例 (#33) | ### workSystem 示例 | 表单名称 | 表单ID | 说明 | |----------|--------|------| | 数据接口调用字段示例 | 469500336084679173 | autoComplete + select + cascader + popupSelect | --- ## 系统自动填充控件 | 控件 | jnpfKey | 说明 | workSystem 示例 | |------|---------|------|-----------------| | 创建用户 | createUser | 自动填充当前用户 | #43, #46, #47, #49 | | 创建时间 | createTime | 自动填充创建时间 | #46, #47, #49, #55 | | 修改时间 | modifyTime | 自动填充修改时间 | #49, #55 | | 当前组织 | currOrganize | 自动填充当前组织 | #47, #51 | | 区域选择 | areaSelect | 省市区选择 | #52, #59 | --- ## 数据存储规律 ### 特殊控件存储规律 | 控件 | jnpfKey | 存储类型 | 存储格式示例 | 说明 | |------|---------|---------|------------|------| | 开关 | `switch` | **字符串** | `"1"` / `"0"` | activeValue/inactiveValue 转字符串存储,数据库类型 varchar(255) | | 评分 | `rate` | **decimal(38,1)** | `4.0` | 存储为 decimal(38,1),如 4.0 表示4星 | | 滑块 | `slider` | **decimal(38,15)** | `50.000000000000000` | 高精度 decimal 存储,非整数 | | 颜色选择 | `colorPicker` | **字符串** | `"#1890ff"` | 十六进制颜色值 | | 签章 | `sign` | **字符串** | `"/files/sign/xxx.png"` | 签章图片路径 | | 二维码 | `qrcode` | **字符串** | `"http://xxx"` | 二维码内容 | | 条形码 | `barcode` | **字符串** | `"123456789"` | 条形码内容 | | 单据规则 | `billRule` | **字符串** | `"BJ20260407001"` | 自动生成的编号 | | 计算 | `calculate` | **数值** | `1234.56` | 计算结果值 | ### 开关控件详解 开关的存储值由 `activeValue` 和 `inactiveValue` 决定: | 配置 | activeValue | inactiveValue | 开启存储 | 关闭存储 | |------|------------|---------------|---------|---------| | 默认 | `true` | `false` | `1` | `0` | | 数值型 | `"1"` | `"0"` | `"1"` | `"0"` | | 布尔型 | `"true"` | `"false"` | `"true"` | `"false"` | ### AIBridge 配置示例 ```python # 默认开关(存储 1/0) field = build_field_model( field_name="是否启用", field_vmodel="f_enabled", jnpf_key="switch" ) # 自定义值 field = build_field_model( field_name="接收通知", field_vmodel="f_receive_notification", jnpf_key="switch", activeValue="1", inactiveValue="0" ) ``` ### 地址选择控件 | 控件 | jnpfKey | 存储类型 | 存储格式示例 | |------|---------|---------|------------| | 地址选择 | `address` | **纯文本字符串** | `"广东省东莞市万江区家达能大厦74B"` | 实际存储为纯地址文本,非 JSON 对象 | ### 存储验证示例 ```python # 开关(实际存储为字符串) f_enabled: "1" # 开启,varchar(255) 存储 # 评分(实际存储为 decimal(38,1)) f_rating: Decimal('4.0') # 4星 # 滑块(实际存储为高精度 decimal(38,15)) f_opacity: Decimal('50.000000000000000') # 50% # 颜色 f_color: "#1890ff" # 地址(实际存储为纯文本,非 JSON 对象) f_address: '广东省东莞市万江区家达能大厦74B' ``` ### 数据库字段要求 | 控件 | 建议字段类型 | |------|------------| | switch | `varchar(255)` | | rate | `decimal(38,1)` | | slider | `decimal(38,15)` | | colorPicker | `varchar(255)` | | sign/qrcode/barcode | `varchar(500)` 或 `text` | | billRule | `varchar(50)` | | calculate | `decimal(18,2)` | | address | `varchar(255)` | --- ## 下一步 - [图表控件](09-chart-controls.md) - [表格高级模式](10-table-patterns.md) - [表单高级模式](11-form-patterns.md)