# 移动端控件
## 目录
- [概述](#概述)
- [移动端组件清单](#移动端组件清单)
- [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)