uniapp中uview组件库的丰富Upload 上传上午用法

2023-12-30 21:39:48

目录

基础用法

#上传视频

#文件预览

#隐藏上传按钮

#限制上传数量

#自定义上传样式

API

#Props

#Methods

#Slot

#Events


基础用法

  • 可以通过设置fileList参数(数组,元素为对象),显示预置的图片。其中元素的url属性为图片路径
<template>
	<u-upload
		:fileList="fileList1"
		@afterRead="afterRead"
		@delete="deletePic"
		name="1"
		multiple
		:maxCount="10"
	></u-upload>
</template>

<script>
	export default {
		data() {
			return {
				fileList1: [],
			}
		},
		methods:{
			// 删除图片
			deletePic(event) {
				this[`fileList${event.name}`].splice(event.index, 1)
			},
			// 新增图片
			async afterRead(event) {
				// 当设置 multiple 为 true 时, file 为数组格式,否则为对象格式
				let lists = [].concat(event.file)
				let fileListLen = this[`fileList${event.name}`].length
				lists.map((item) => {
					this[`fileList${event.name}`].push({
						...item,
						status: 'uploading',
						message: '上传中'
					})
				})
				for (let i = 0; i < lists.length; i++) {
					const result = await this.uploadFilePromise(lists[i].url)
					let item = this[`fileList${event.name}`][fileListLen]
					this[`fileList${event.name}`].splice(fileListLen, 1, Object.assign(item, {
						status: 'success',
						message: '',
						url: result
					}))
					fileListLen++
				}
			},
			uploadFilePromise(url) {
				return new Promise((resolve, reject) => {
					let a = uni.uploadFile({
						url: 'http://192.168.2.21:7001/upload', // 仅为示例,非真实的接口地址
						filePath: url,
						name: 'file',
						formData: {
							user: 'test'
						},
						success: (res) => {
							setTimeout(() => {
								resolve(res.data.data)
							}, 1000)
						}
					});
				})
			},
		}

	}
</script>

#上传视频

  • 通过设置accept='video'属性,将上传改为视频上传。
<u-upload
	:fileList="fileList2"
	@afterRead="afterRead"
	@delete="deletePic"
	name="2"
	multiple
	:maxCount="10"
	accept="video"
></u-upload>
<!-- data 方法请参考 基本用法 -->
data(){
	return{
		fileList2: [],
	}
}

#文件预览

  • 通过设置:previewFullImage="true"'属性,达到文件预览的目的。
<u-upload
	:fileList="fileList3"
	@afterRead="afterRead"
	@delete="deletePic"
	name="3"
	multiple
	:maxCount="10"
	:previewFullImage="true"
></u-upload>
<!-- data 方法请参考 基本用法 -->
data(){
	return{
		fileList3: [{
			url: 'https://cdn.uviewui.com/uview/swiper/1.jpg',
		}],
	}
}

#隐藏上传按钮

  • 上传数量等于maxCount所规定的数据时,隐藏上传按钮。
<u-upload
	:fileList="fileList4"
	@afterRead="afterRead"
	@delete="deletePic"
	name="4"
	multiple
	:maxCount="2"
></u-upload>
<!-- data 方法请参考 基本用法 -->
data(){
	return{
		fileList4: [{
				url: 'https://cdn.uviewui.com/uview/swiper/1.jpg',
			},
			{
				url: 'https://cdn.uviewui.com/uview/swiper/1.jpg',
			}
		],
	}
}

#限制上传数量

  • 同上,规定maxCount的数据时。
<u-upload
	:fileList="fileList5"
	@afterRead="afterRead"
	@delete="deletePic"
	name="5"
	multiple
	:maxCount="3"
></u-upload>
<!-- data 方法请参考 基本用法 -->
data(){
	return{
		fileList5: [],
	}
}

#自定义上传样式

  • 添加image以自定义上传样式,达到身份证,银行卡等不同场景需求。
<u-upload
	:fileList="fileList6"
	@afterRead="afterRead"
	@delete="deletePic"
	name="6"
	multiple
	:maxCount="1"
	width="250"
	height="150"
>
	<image src="https://cdn.uviewui.com/uview/demo/upload/positive.png" 
	mode="widthFix" style="width: 250px;height: 150px;"></image>
</u-upload>
<!-- data 方法请参考 基本用法 -->
data(){
	return{
		fileList6: [],
	}
}

API

#Props

参数说明类型默认值可选值
accept接受的文件类型,file只支持H5(只有微信小程序才支持把accept配置为all、media)Stringimageall | media | image | file | video
capture图片或视频拾取模式,当accept为image类型时设置capture可选额外camera可以直接调起摄像头String | Array['album', 'camera']-
compressed当accept为video时生效,是否压缩视频,默认为trueBooleantruefalse
camera当accept为video时生效,可选值为back或frontStringback-
maxDuration当accept为video时生效,拍摄视频最长拍摄时间,单位秒Number60true
uploadIcon上传区域的图标,只能内置图标Stringcamera-fill-
uploadIconColor上传区域的图标的颜色String#D3D4D6-
useBeforeRead是否启用(显示/隐藏)组件Booleanfalsetrue
previewFullImagepreviewFullImageBooleantruefalse
maxCount最大选择图片的数量String | Number52-
disabled是否启用(显示/隐藏)组件Booleanfalsetrue
imageMode预览上传的图片时的裁剪模式,和image组件mode属性一致StringaspectFill-
name标识符,可以在回调函数的第二项参数中获取Stringfile-
sizeTypeoriginal 原图,compressed 压缩图,默认二者都有,H5无效Array<String>['original', 'compressed']-
multiple是否开启图片多选,部分安卓机型不支持Booleanfalsetrue
deletable是否显示删除图片的按钮Booleantruefalse
maxSize选择单个文件的最大大小,单位B(byte),默认不限制String | NumberNumber.MAX_VALUE-
fileList显示已上传的文件列表Array--
uploadText上传区域的提示文字String--
width内部预览图片区域和选择图片按钮的区域宽度,单位rpx,不能是百分比,或者autoString | Number80-
height内部预览图片区域和选择图片按钮的区域高度,单位rpx,不能是百分比,或者autoString | Number80-
previewImage是否在上传完成后展示预览图Booleantruefalse

#Methods

此方法如要通过ref手动调用

名称说明
afterRead读取后的处理函数
beforeRead读取前的处理函数

#Slot

slot中您可以内置任何您所需要的样式。

名称说明
-(default)自定义上传样式

#Events

回调参数中的event参数,为当前删除元素的所有信息,index为当前操作的图片的索引,name为删除名称,file包含删除的url信息

事件名说明回调参数
afterRead读取后的处理函数(file, lists, name),错误信息
beforeRead读取前的处理函数(file, lists, name),错误信息
oversize图片大小超出最大允许大小(file, lists, name), name为通过props传递的index参数
clickPreview全屏预览图片时触发(url, lists, name),url为当前选中的图片地址,index为通过props传递的index参数
delete删除图片传递index?回调 event 参数 包含index,file,name

文章来源:https://blog.csdn.net/m0_72603435/article/details/135309084
本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。