# 移动端控件 ## 目录 - [概述](#概述) - [移动端组件清单](#移动端组件清单) - [f_app_column_data 解析](#f_app_column_data-解析) - [PC端与移动端差异](#pc端与移动端差异) --- ## 概述 ### 源码位置 ``` $ccWorkDir/jnpf/移动端/jnpf-app-vue3/components/Jnpf/ ``` ### 组件数量 共 **55 个** Jnpf 组件,涵盖输入、选择、日期、上传、特殊功能等类别。 --- ## 移动端组件清单 ### 输入类 | 组件 | 目录 | 说明 | |------|------|------| | Input | Input/ | 单行文本输入 | | InputNumber | InputNumber/ | 数字输入 | | Textarea | Textarea/ | 多行文本输入 | ### 选择类 | 组件 | 目录 | 说明 | |------|------|------| | Select | Select/ | 下拉选择 | | Radio | Radio/ | 单选 | | Checkbox | Checkbox/ | 多选 | | TreeSelect | TreeSelect/ | 树形选择 | | Cascader | Cascader/ | 级联选择 | | OrganizeSelect | OrganizeSelect/ | 组织选择 | | UserSelect | UserSelect/ | 用户选择 | | UsersSelect | UsersSelect/ | 多用户选择 | | RoleSelect | RoleSelect/ | 角色选择 | | GroupSelect | GroupSelect/ | 分组选择 | | AreaSelect | AreaSelect/ | 区域选择 | | PosSelect | PosSelect/ | 职位选择 | | MultSelect | MultSelect/ | 多选 | ### 日期时间类 | 组件 | 目录 | 说明 | |------|------|------| | DatePicker | DatePicker/ | 日期选择 | | TimePicker | TimePicker/ | 时间选择 | | DateRange | DateRange/ | 日期范围 | | TimeRange | TimeRange/ | 时间范围 | | NumberRange | NumberRange/ | 数字范围 | ### 上传类 | 组件 | 目录 | 说明 | |------|------|------| | UploadImg | UploadImg/ | 图片上传 | | UploadFile | UploadFile/ | 文件上传 | | UploadFileH | UploadFileH/ | H5文件上传 | | UploadFileComment | UploadFileComment/ | 评论文件上传 | ### 特殊功能类 | 组件 | 目录 | 说明 | |------|------|------| | Switch | Switch/ | 开关 | | Slider | Slider/ | 滑块 | | Rate | Rate/ | 评分 | | ColorPicker | ColorPicker/ | 颜色选择 | | Steps | Steps/ | 步骤 | | Signature | Signature/ | 电子签名 | | Sign | Sign/ | 签章 | | Barcode | Barcode/ | 条形码 | | Qrcode | Qrcode/ | 二维码 | | Ocr | Ocr/ | OCR识别 | | Location | Location/ | 定位 | | Link | Link/ | 链接 | | Alert | Alert/ | 警告提示 | | Text | Text/ | 文本显示 | | Button | Button/ | 按钮 | | Empty | Empty/ | 空状态 | | Divider | Divider/ | 分隔线 | | GroupTitle | GroupTitle/ | 分组标题 | | Carousel | Carousel/ | 轮播 | | Editor | Editor/ | 富文本编辑器 | ### 弹窗类 | 组件 | 目录 | 说明 | |------|------|------| | PopupSelect | PopupSelect/ | 弹窗选择 | | PopupAttr | PopupAttr/ | 弹窗属性 | | RelationForm | RelationForm/ | 关联表单 | | RelationFormAttr | RelationFormAttr/ | 关联表单属性 | | Parser | Parser/ | 解析器 | | ChildTable | Parser/childTable.vue | 子表格 | ### 计算类 | 组件 | 目录 | 说明 | |------|------|------| | Calculate | Calculate/ | 计算 | | DateCalculate | DateCalculate/ | 日期计算 | --- ## f_app_column_data 解析 ### 基本概念 `f_app_column_data` 是 JNPF 移动端动态表单配置的 JSON 字段,用于定义移动端表单的渲染规则。 ### 数据库字段 | 字段 | 说明 | |------|------| | f_app_column_data | 移动端表单列配置 (JSON) | | f_app_form_data | 移动端表单数据配置 (JSON) | ### 配置结构 ```json { "columnData": [ { "column": "f_customer_name", "component": "Input", "props": { "placeholder": "请输入客户名称", "disabled": false } }, { "column": "f_status", "component": "Select", "props": { "placeholder": "请选择状态", "options": [ {"label": "启用", "value": "1"}, {"label": "禁用", "value": "0"} ] } } ] } ``` ### 组件映射 | PC 控件 | 移动端组件 | 说明 | |---------|------------|------| | input | Input | 单行文本 | | textarea | Textarea | 多行文本 | | inputNumber | InputNumber | 数字输入 | | select | Select | 下拉选择 | | radio | Radio | 单选 | | checkbox | Checkbox | 多选 | | date | DatePicker | 日期选择 | | datetime | DatePicker | 日期时间 | | time | TimePicker | 时间选择 | | switch | Switch | 开关 | | uploadImg | UploadImg | 图片上传 | | uploadFile | UploadFile | 文件上传 | | treeSelect | TreeSelect | 树形选择 | | cascader | Cascader | 级联选择 | | organizeSelect | OrganizeSelect | 组织选择 | | userSelect | UserSelect | 用户选择 | ### Props 传递 移动端组件通过 `props` 对象传递配置: ```json { "column": "f_field_name", "component": "ComponentName", "props": { "placeholder": "提示文本", "disabled": false, "clearable": true, "multiple": false } } ``` --- ## PC端与移动端差异 ### 组件命名差异 | PC jnpfKey | 移动端组件 | |------------|-----------| | input | Input | | textarea | Textarea | | inputNumber | InputNumber | | select | Select | | datePicker | DatePicker | | time | TimePicker | | uploadImg | UploadImg | | uploadFile | UploadFile | ### 特有移动端控件 以下控件**仅移动端**可用: | 组件 | 说明 | |------|------| | Location | GPS定位 | | Ocr | OCR文字识别 | | Steps | 步骤指示器 | | NumberRange | 数字范围选择 | | DateRange | 日期范围选择 | | TimeRange | 时间范围选择 | | UploadFileH | H5文件上传 (跨平台) | | UploadFileComment | 评论文件上传 | ### 表单配置差异 | 特性 | PC端 | 移动端 | |------|------|--------| | 配置字段 | formData | f_app_column_data | | 列表配置 | columnData | f_app_column_data | | 默认值 | __config__.defaultValue | props.defaultValue | | 必填校验 | __config__.required | rules.required | | 禁用状态 | disabled | props.disabled | --- ## 使用示例 ### 移动端表单配置 ```json { "f_app_column_data": "{\"columnData\":[{\"column\":\"f_customer_name\",\"component\":\"Input\",\"props\":{\"placeholder\":\"请输入客户名称\"}},{\"column\":\"f_order_date\",\"component\":\"DatePicker\",\"props\":{\"format\":\"YYYY-MM-DD\"}},{\"column\":\"f_status\",\"component\":\"Select\",\"props\":{\"placeholder\":\"请选择状态\",\"options\":[{\"label\":\"启用\",\"value\":\"1\"},{\"label\":\"禁用\",\"value\":\"0\"}]}}]}" } ``` ### 移动端组件使用 ```vue ``` --- ## 下一步 - [PC端控件速查](01-quick-ref.md) - [workSystem 示例](12-examples/workSystem-examples.md) - [extend 代码示例](12-examples/extend-examples.md)