更新记录
1.0.0(2025-06-03)
下载此版本
首次上传
平台兼容性
uni-app(4.01)
Vue2 |
Vue3 |
Chrome |
Safari |
app-vue |
app-nvue |
Android |
iOS |
鸿蒙 |
√ |
√ |
√ |
√ |
√ |
- |
√ |
√ |
- |
微信小程序 |
支付宝小程序 |
抖音小程序 |
百度小程序 |
快手小程序 |
京东小程序 |
鸿蒙元服务 |
QQ小程序 |
飞书小程序 |
快应用-华为 |
快应用-联盟 |
√ |
- |
- |
- |
- |
- |
- |
- |
- |
- |
- |
其他
注意事项
1、imgUpUrl 图片上传的接口路径 必填,如果需要传token 自行修改插件上传方法的herder
2、接口返回值取的res.data.data,如果接口返回结构不一样需自行修改
3、图片回显用的fullurl字段,如果不一样自行修改
基础参数
属性名 |
类型 |
默认值 |
说明 |
v-model |
Array |
[] |
双向绑定图片列表 |
imgUpUrl |
String |
`` |
必填,也可以修改imgUpUrl的default |
limit |
Number |
9 |
上传数量限制 |
dsb |
Boolean |
false |
是否禁用选择 |
width |
String |
135rpx |
回显图片的宽度 |
height |
String |
135rpx |
回显图片的高度 |
sourceType |
Array |
['album', 'camera'] |
相册相机 |
closeIcon |
String |
默认 |
删除图片按钮图标 |
addIcon |
String |
默认 |
添加图片按钮图标 |
事件回调
事件名 |
类型 |
说明 |
@change |
Handler |
图片列表数据变化是触发 |
代码使用示例
<template>
<view class="page-bg">
<view class="form-item">
<view class="label">多张图片:</view>
<view class="item-value">
<imgUpload v-model="imgArr1"></imgUpload>
</view>
</view>
<view class="form-item">
<view class="label">单张图片:</view>
<view class="item-value">
<imgUpload v-model="imgArr2" :limit="1"></imgUpload>
</view>
</view>
<view class="form-item">
<view class="label">身份证:</view>
<view class="item-value">
<imgUpload v-model="idCardImg" :limit="1" width="300rpx" height="200rpx">
<view class="card-box" style="width: 300rpx;height:200rpx;">身份证上传</view>
</imgUpload>
</view>
</view>
</view>
</template>
<script>
import imgUpload from '@/components/imgUpload.vue'
export default {
components: {
imgUpload
},
data() {
return {
imgArr1: [],
imgArr2: [],
idCardImg: []
}
}
}
</script>
<style scoped lang="scss">
.page-bg {
padding: 20rpx;
}
.card-box {
display: flex;
align-items: center;
justify-content: center;
background-color: #999;
}
.form-item {
display: flex;
align-items: center;
.label {
width: 150rpx;
text-align: right;
}
.item-value {
flex: 1;
}
}
</style>