contract-front/uni_modules/wht-img-upload/readme.md

wht-img-upload

一个简单易用的图片上传组件，支持单图/多图上传，适用于 uni-app 项目。

特性

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

安装

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

基础用法

<template>
    <wht-img-upload v-model="imageList" />
</template>
<script>
export default {
    data() {
        return {
            imageList: []
        }
    }
}
</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	-

Events

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