Skip to content

Upload 上传

继承van-uploader所有属性

通过点击或者拖拽上传文件。

基础用法

文件上传完毕后会触发 after-read 回调函数,获取到对应的 file 对象。

文件预览

通过 v-model 可以绑定已经上传的文件列表,并展示文件列表的预览图。

上传状态

通过 status 属性可以标识上传状态,uploading 表示上传中,failed 表示上传失败,done 表示上传完成。

限制上传数量

通过 max-count 属性可以限制上传文件的数量,上传数量达到限制后,会自动隐藏上传区域。

限制上传大小

通过 max-size 属性可以限制上传文件的大小,超过大小的文件会被自动过滤,这些文件信息可以通过 oversize 事件获取。

API

Props

属性说明类型默认值
v-model已上传的文件列表Array-
accept接受的文件类型stringimage/*
name上传的文件字段名stringfile
preview-size预览图和上传区域的大小,默认单位为 pxnumber | string | Array80px
preview-image是否展示预览图booleantrue
preview-options预览图的选项,具体见下方表格object-
multiple是否可以上传多个文件booleanfalse
disabled是否禁用文件上传booleanfalse
readonly是否只读,只读状态下无法选择文件,无法上传booleanfalse
deletable是否可以删除已上传的文件booleantrue
reupload是否覆盖上传booleanfalse
show-upload是否展示上传区域booleantrue
lazy-load是否延迟加载图片booleanfalse
capture图片捕获属性stringcamera
after-read文件读取完成后的回调函数(file: File) => void-
before-read文件读取前的回调函数,返回 true 表示校验通过,返回 false 表示校验失败(file: File) => boolean-
before-delete文件删除前的回调函数,返回 true 表示删除成功,返回 false 表示删除失败(file: File, index: number) => boolean-
max-size文件大小限制,单位为 bytenumber | (file: File) => boolean-
max-count文件数量限制number-
result-type文件读取结果类型,可选值为 dataUrl text filestringdataUrl
upload-text上传区域文字提示string上传
image-fit预览图的裁剪模式,可选值为 contain cover fill none scale-downstringcover
upload-icon上传区域图标stringphotograph

注意:accept、capture 和 multiple 为浏览器 input 标签的原生属性,移动端各种机型对这些属性的支持程度有所差异,因此在不同机型和 WebView 下可能出现一些兼容性问题。