更新记录

1.0.0（2025-09-10）

## [1.0.0] - 2025-09-10
### Added
-   初次发布。
-   实现基本图片选择、预览、删除功能。
-   支持自定义数量、来源、样式等。
-   提供编辑事件触发（裁剪、旋转）。
-   完善组件事件与方法。

平台兼容性

uni-app(4.08)

uni-app x(4.07)

其他

hy-image-picker-plus 增强型图片选择器

一个功能丰富、高度可定制的uni-app图片选择器组件。

特性

• 🖼️ 多图选择与预览: 支持一次性选择多张图片并流畅预览。
• ✂️ 基本编辑功能: 支持触发裁剪、旋转等编辑操作（需配合相应逻辑或插件）。
• 🎨 高度自定义: 可灵活配置数量、来源、样式、按钮文字等。
• 📱 多端兼容: 支持App、H5、微信小程序、支付宝小程序等平台。
• 🔒 无权限依赖: 纯UI组件，不涉及任何敏感权限。

安装

1. 通过HBuilderX的uni_modules导入本插件。
2. 或手动将本插件放入你项目的uni_modules目录下。

使用方法

基本使用

<template>
  <view>
    <hy-image-picker-plus v-model="imageList" @select="" @delete="onDelete"></hy-image-picker-plus>
  </view>
</template>

<script>
export default {
  data() {
    return {
      imageList: []
    };
  },
  methods: {
    (e) {
      console.log('选择图片：', e.tempFilePaths);
      // 可以在此处触发上传逻辑
    },
    onDelete(e) {
      console.log('删除图片：', e.index, e.file);
    }
  }
};
</script>

配置参数

属性               类型             默认值                        说明
value/v-model   Array                []                      已选择的图片列表，每一项为Object，包含path或url
maxFile         Number               9                       最大可选图片数量
fileMediatype   String            'image'                    文件类型 'image' / 'video'
sizeType        Array     ['original', 'compressed']        压缩图 original 原图，compressed 压缩图
sourceType      Array       ['album', 'camera']             选择来源 ['album', 'camera']
uploadText      String          '选择图片'                  选择按钮的文字
editable        Boolean           false                    是否显示编辑按钮
autoUpload      Boolean           true                     选择后是否自动触发上传事件
cameraIcon      String            ...                      相机图标路径
deleteIcon      String            ...                      删除图标路径
editIcon        String            ...                      编辑图标路径

事件

事件名              说明                               回调参数
@input           数据更新时触发                          更新后的图片列表
@select          选择图片成功时触发                   { files, tempFilePaths }
@delete          删除图片时触发                         { index, file }
@preview         预览图片时触发                         { index, file }
@fail            选择图片失败时触发                   错误信息
@upload          需上传图片时触发(若autoUpload为true) { files, tempFilePaths }
@edit-crop      点击编辑-裁剪时触发                  { index, file }
@edit-rotate    点击编辑-旋转时触发                  { index, file }
@longpress      长按预览图片时触发                   { index, file }

方法

方法名          说明         参数
chooseImage     手动触发选择图片    -
deleteImage     手动删除指定图片    index
previewImage    手动预览指定图片    index

本插件主要处理图片选择与预览，上传逻辑需要开发者自行实现（监听@upload或@select事件）