更新记录
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 |