更新记录

1.0.0(2025-07-08) 下载此版本

图片上传组件,支持单图/多图上传,添加水印上传压缩,适用于 uni-app 项目。


平台兼容性

uni-app(4.06)

Vue2 Vue3 Chrome Safari app-vue app-nvue Android iOS 鸿蒙
- -
微信小程序 支付宝小程序 抖音小程序 百度小程序 快手小程序 京东小程序 鸿蒙元服务 QQ小程序 飞书小程序 快应用-华为 快应用-联盟
- - - - - -

uni-app x(4.06)

Chrome Safari Android iOS 鸿蒙 微信小程序
- - - - - -

其他

多语言 暗黑模式 宽屏模式
× ×

lsj-image-upload

图片上传组件,支持单图/多图上传,添加水印上传压缩,适用于 uni-app 项目。

特性

  • 支持单图/多图上传
  • 支持自定义列数和间距
  • 支持上传进度显示
  • 支持预览和删除
  • 支持自定义上传配置
  • 支持添加自定义水印

安装

在插件市场中搜索 lsj-image-upload 并导入到项目中。

基础用法

<template>
    <lsj-image-upload v-model="imageList" :upload-config="upload_config" :watermarkConfig="watermark_config" />
</template>
<script setup>
import { ref } from 'vue'
const imageList = ref([])const upload_config = ref({
    url: 'http://xxx.com',
    name: 'file',
    header: {
        'Authorization': uni.getStorageSync('token') ? `Bearer ` + uni.getStorageSync('token') : '',
        'tenant-id': 2,
    },
    enabled: true
})
const image_arr = ref([])
const watermark_config = ref({
    // 是否启用水印
    enabled: true,
    // 水印文本数组(多行水印)
    texts: ['公司名称', '用户信息', '位置信息'],
    // 水印字体大小
    fontSize: 16,
    // 水印颜色
    color: "#fff",
    // 水印位置 (支持: top-left, top-right, bottom-left, bottom-right, center)
    position: "top-left",
    // 水印旋转角度
    rotate: 0,
    // 水印间距
    spacing: 80,
    // 水印边距
    padding: 20,
    // 水印透明度
    opacity: 1,
    format: 'jpg', // 可选值:'jpg', 'png'
    quality: 0.8, // 压缩质量(0-1)
})
</script>

API

Props

参数 说明 类型 默认值
modelValue/v-model 图片列表 Array []
max 最大上传数量 Number 9
mode 上传模式,可选值:single/multi String 'multi'
columns 列数 Number 3
gap 间距(rpx) Number 24
itemHeight 图片高度(rpx) Number 216
buttonText 上传按钮文字 String '上传图片'
showButtonText 是否显示按钮文字 Boolean true
uploadConfig 上传配置 Object -
watermarkConfig 水印配置 Object -

uploadConfig

参数 说明 类型 默认值
url 上传路径 String -
name 文件名 String 'file'
header 请求头 Object -
formData 额外参数 Object -

watermarkConfig

参数 说明 类型 默认值
enabled 是否启用水印 Boolean true
texts 水印本文组 Array ['位置','时间','用户']
color 水印颜色 String '#fff'
position 水印位置(支持: top-left, top-right, bottom-left, bottom-right, center) String 'bottom-right'
quality 压缩质量(0-1) Number 0.8
fontSize 字体大小 Number 16

Events

事件名 说明 回调参数
update:modelValue 图片列表更新时触发 imageList
choose 选择图片后触发 imageList
delete 删除图片时触发 index
error 上传错误时触发 error

隐私、权限声明

1. 本插件需要申请的系统权限列表:

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

许可协议

MIT协议

暂无用户评论。

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问