TUI

Upload 图片上传
TsUpload 是一款简洁灵活的图片上传组件,支持多文件上传、大小限制、缩略图展示等功能。
默认提供按钮样式和缩略图展示方式,结合简易配置即可快速集成至业务系统。
基础用法
无需额外配置,即可快速实现单张图片上传。
可通过 text 自定义按钮文案,filekm 设置最大上传文件大小,limit 控制上传数量。
示例代码
vue
缩略图上传模式
设置 mode="thumbnail" 启用缩略图上传样式,适用于头像、图片展示类场景。
+
示例代码
vue
拖拽上传
开启 dropZone 模式后,可将文件直接拖入指定区域完成上传。搭配 slot 轻松实现上传的自定义样式。
拖动文件到此处上传
示例代码
vue
自定义 slot 组成头像上传
通过 slot 自定义上传区域内容,这里以 TsAvatar 作为上传按钮和展示容器。
点击上传
示例代码
vue
属性 Props
属性名
说明
类型
可选值
默认值
版本说明
text
上传按钮文字
string
-
选择图片
list
图片列表
string[]
-
[]
filekm
文件大小限制, 单位KB, M
string
-
20M
multiple
是否支持多选
boolean
-
false
limit
最大上传数量
number
-
1
mode
模式类型
string
button / thumbnail
button
previewList
预览列表
string[]
-
[]
dropZone
是否支持拖拽上传, mode 为 button 时禁用
boolean
-
false
0.3.3 新增
width
上传区域宽度, 主要用于 slot 自定义的交互区域宽度
string | number
-
height
上传区域高度, 主要用于 slot 自定义的交互区域高度, 默认同步 width
string | number
-
0.3.5 版本新增
previewable
是否可以预览
boolean
-
true
0.0.8 版本新增
resetable
是否可以重置,0.0.8 版本新增
[boolean, string, Null]
-
false
limitErrorText
是否可以重置,0.2.9 版本新增
string
-
添加的文件数量超出限制
事件 Events
事件名
说明
回调参数
版本说明
onChange
获取文件, 选择文件后回调,multiple 为 true 时, 一次性返回所有文件
(value: Array<Files | string>) => void
getBase64
获取当前操作的图片base64, 仅在 accept 为 image/* 时生效
(value: string | ArrayBuffer | null)=> void
error
文件选择失败的回调
(value: string) => void
插槽 Slots
插槽名
说明
版本说明
default
自定义上传区域
基础用法
缩略图上传模式
拖拽上传
自定义 slot 组成头像上传
属性 Props
事件 Events
插槽 Slots