Files
aibridge/docs/control/13-mobile-controls.md
2026-05-18 09:28:15 +08:00

7.3 KiB

移动端控件

目录


概述

源码位置

$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)

配置结构

{
  "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 对象传递配置:

{
  "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

使用示例

移动端表单配置

{
  "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\"}]}}]}"
}

移动端组件使用

<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>

下一步