299 lines
7.3 KiB
Markdown
299 lines
7.3 KiB
Markdown
# 移动端控件
|
|
|
|
## 目录
|
|
|
|
- [概述](#概述)
|
|
- [移动端组件清单](#移动端组件清单)
|
|
- [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
|
|
<template>
|
|
<view class="form-container">
|
|
<JnpfInput
|
|
v-model="form.f_customer_name"
|
|
:props="{ placeholder: '请输入客户名称' }"
|
|
/>
|
|
<JnpfDatePicker
|
|
v-model="form.f_order_date"
|
|
:props="{ format: 'YYYY-MM-DD' }"
|
|
/>
|
|
<JnpfSelect
|
|
v-model="form.f_status"
|
|
:props="{
|
|
placeholder: '请选择状态',
|
|
options: statusOptions
|
|
}"
|
|
/>
|
|
</view>
|
|
</template>
|
|
|
|
<script setup>
|
|
import JnpfInput from '@/components/Jnpf/Input/index.vue';
|
|
import JnpfDatePicker from '@/components/Jnpf/DatePicker/index.vue';
|
|
import JnpfSelect from '@/components/Jnpf/Select/index.vue';
|
|
|
|
const form = reactive({
|
|
f_customer_name: '',
|
|
f_order_date: '',
|
|
f_status: ''
|
|
});
|
|
|
|
const statusOptions = [
|
|
{ label: '启用', value: '1' },
|
|
{ label: '禁用', value: '0' }
|
|
];
|
|
</script>
|
|
```
|
|
|
|
---
|
|
|
|
## 下一步
|
|
|
|
- [PC端控件速查](01-quick-ref.md)
|
|
- [workSystem 示例](12-examples/workSystem-examples.md)
|
|
- [extend 代码示例](12-examples/extend-examples.md)
|