CImagePicker 图片选择器组件

功能说明

CImagePicker 是一个图片选择器组件，用于在表单中上传和管理图片。组件支持单张和多张图片上传，支持预览、删除等功能，并且可以限制上传图片的数量和来源。

引用方式

import { CImagePicker } from '@components/forms/imagePicker';

组件参数

• itemRes (Object，必填)：表单数据资源对象，表单组件内部机制专用
• count (Number，可选)：最大图片张数，默认为 1
• sourceType (Array，可选)：图片来源，默认为 ['album', 'camera']
• album：从相册选择
• camera：使用相机
• params (Object，可选)：上传图片的附加参数，默认为空对象
• needThumb (Boolean，可选)：是否开启缩略图，默认为 false

实例方法

• $uploadImage(callback)：上传图片到服务器，参数为回调函数，回调函数接收两个参数：状态和结果

使用示例

基础用法

<template>
  <CForm :form="form">
    <CFormItem name="photos" label="图片上传">
      <CImagePicker 
        :count="3" 
        placeholder="请上传图片" 
      />
    </CFormItem>
  </CForm>
</template>

<script>
import { CForm, CFormItem } from '@components/forms/form';
import { CImagePicker } from '@components/forms/imagePicker';

export default {
  components: {
    CForm,
    CFormItem,
    CImagePicker
  },
  data() {
    return {
      form: {
        photos: []
      }
    };
  }
};
</script>

限制图片来源

<CFormItem name="idCard" label="身份证照片">
  <CImagePicker 
    :count="1" 
    :sourceType="['camera']" 
    placeholder="请拍摄身份证照片" 
  />
</CFormItem>

使用上传方法

<template>
  <CForm :form="form">
    <CFormItem name="certificate" label="证书照片">
      <CImagePicker 
        ref="imagePicker"
        :count="1" 
        :params="{type: 'certificate'}" 
        :needThumb="true"
        placeholder="请上传证书照片" 
      />
    </CFormItem>
    <button @tap="evt => handleUpload()">上传图片</button>
  </CForm>
</template>

<script>
export default {
  // ...
  methods: {
    handleUpload() {
      this.$refs.imagePicker.$uploadImage((state, result) => {
        if (state === 'success') {
          console.log('上传成功', result);
        } else {
          console.error('上传失败', result);
        }
      });
    }
  }
};
</script>

注意事项

1. 组件会自动过滤不支持的图片格式，只允许上传 gif、png、jpg、jpeg 格式的图片
2. 图片大小超过 1MB 的会自动进行压缩处理
3. 通过 $uploadImage 方法可以将图片上传到服务器，上传成功后会自动更新表单值
4. 如果设置了 needThumb 为 true，上传时会同时生成缩略图
5. 组件内部集成了图片预览功能，点击已上传的图片可以放大查看