Vue上传组件vue Simple Uploader的用法示例
发布时间 - 2026-01-11 02:57:41 点击率:次在日常开发中经常会遇到文件上传的需求,vue-simple-uploader 就是一个基于 simple-uploader.js 和 Vue 结合做的一个上传组件,自带 UI,可覆盖、自定义;先来张动图看看效果:
其主要特点就是:
- 支持文件、多文件、文件夹上传
- 支持拖拽文件、文件夹上传
- 统一对待文件和文件夹,方便操作管理
- 可暂停、继续上传
- 错误处理
- 支持“快传”,通过文件判断服务端是否已存在从而实现“快传”
- 上传队列管理,支持最大并发上传
- 分块上传
- 支持进度、预估剩余时间、出错自动重试、重传等操作
安装
通过npm安装:npm install vue-simple-uploader --save即可。
使用
初始化
import Vue from 'vue'
import uploader from 'vue-simple-uploader'
import App from './App.vue'
Vue.use(uploader)
/* eslint-disable no-new */
new Vue({
render(createElement) {
return createElement(App)
}
}).$mount('#app')
App.vue
<template>
<uploader :options="options" class="uploader-example">
<uploader-unsupport></uploader-unsupport>
<uploader-drop>
<p>Drop files here to upload or</p>
<uploader-btn>select files</uploader-btn>
<uploader-btn :attrs="attrs">select images</uploader-btn>
<uploader-btn :directory="true">select folder</uploader-btn>
</uploader-drop>
<uploader-list></uploader-list>
</uploader>
</template>
<script>
export default {
data () {
return {
options: {
// 可通过 https://github.com/simple-uploader/Uploader/tree/develop/samples/Node.js 示例启动服务
target: '//localhost:3000/upload',
testChunks: false
},
attrs: {
accept: 'image/*'
}
}
}
}
</script>
<style>
.uploader-example {
width: 880px;
padding: 15px;
margin: 40px auto 0;
font-size: 12px;
box-shadow: 0 0 10px rgba(0, 0, 0, .4);
}
.uploader-example .uploader-btn {
margin-right: 4px;
}
.uploader-example .uploader-list {
max-height: 440px;
overflow: auto;
overflow-x: hidden;
overflow-y: auto;
}
</style>
组件
Uploader
上传根组件,可理解为一个上传器。
Props
options {Object}
参考 simple-uploader.js 配置。
autoStart {Boolean}
默认 true, 是否选择文件后自动开始上传。
事件
- upload-start 开始上传。
- file-added(file) 添加了一个文件,一般用作文件校验,如果给 file 增加 ignored 属性为 true 的话就会被过滤掉。
- file-removed(file) 移除一个文件(文件夹)。
- files-submitted(files, fileList) 所选择的文件们添加到上传队列后触发。
作用域插槽
- files {Array}纯文件列表,没有文件夹概念。
- fileList {Array}统一对待文件、文件夹列表。
- started是否开始上传了。
UploaderBtn
点选上传文件按钮。
Props
directory {Boolean}
默认 false, 是否是文件夹上传。
single {Boolean}
默认 false, 如果设为 true,则代表一次只能选择一个文件。
attrs {Object}
默认 {}, 添加到 input 元素上的额外属性。
UploaderDrop
拖拽上传区域。
UploaderList
文件、文件夹列表,同等对待。
作用域插槽
fileList {Array}
文件、文件夹组成数组。
UploaderUnsupport
不支持 HTML5 File API 的时候会显示。
UploaderFiles
文件列表,没有文件夹概念,纯文件列表。
Props
file {Uploader.File}
封装的文件实例。
list {Boolean}
如果是在 UploaderList 组件中使用的话,请设置为 true。
作用域插槽
- file {Uploader.File}文件实例。
- list {Boolean}是否在 UploaderList 组件中使用。
- status {String}当前状态,可能是:success, error, uploading, paused, waiting
- name {String}文件名字。
- paused {Boolean}是否暂停了。
- error {Boolean}是否出错了。
- averageSpeed {Number}平均上传速度,单位字节每秒。
- formatedAverageSpeed {String}格式化后的平均上传速度,类似:3 KB / S。
- currentSpeed {Number}当前上传速度,单位字节每秒。
- isComplete {Boolean}是否已经上传完成。
- isUploading {Boolean}是否在上传中。
- size {Number}文件或者文件夹大小。
- formatedSize {Number}格式化后文件或者文件夹大小,类似:10 KB.
- uploadedSize {Number}已经上传大小,单位字节。
- progress {Number}介于 0 到 1 之间的小数,上传进度。
- progressStyle {String}进度样式,transform 属性,类似:{transform: '-50%'}.
- progressingClass {String}正在上传中的时候值为:uploader-file-progressing。
- timeRemaining {Number}预估剩余时间,单位秒。
- formatedTimeRemaining {String}格式化后剩余时间,类似:3 miniutes.
- type {String}文件类型。
- extension {String}文件名后缀,小写。
- fileCategory {String}文件分类,其中之一:folder, document, video, audio, image, unknown。
项目
地址:https://github.com/simple-uploader/vue-uploader。
以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持。
# vue
# 上传组件
# vue.js
# Simple
# Uploader
# vue draggable组件实现拖拽及点击无效问题的解决
# vue中使用input[type="file"]实现文件上传功能
# 自定义input组件如何实现拖拽文件上传
# 上传
# 插槽
# 文件列表
# 在上
# 拖拽
# 就会
# 是在
# 设为
# 错了
# 自定义
# 不支持
# 自带
# 可通过
# 设置为
# 其主要
# 传了
# 先来
# 值为
# 点选
# 服务端
相关栏目:
【
网站优化151355 】
【
网络推广146373 】
【
网络技术251813 】
【
AI营销90571 】
相关推荐:
Claude怎样写结构化提示词_Claude结构化提示词写法【教程】
Laravel如何使用Gate和Policy进行授权?(权限控制)
轻松掌握MySQL函数中的last_insert_id()
如何在IIS7上新建站点并设置安全权限?
创业网站制作流程,创业网站可靠吗?
Python函数文档自动校验_规范解析【教程】
Laravel怎么上传文件_Laravel图片上传及存储配置
使用豆包 AI 辅助进行简单网页 HTML 结构设计
Laravel任务队列怎么用_Laravel Queues异步处理任务提升应用性能
常州企业网站制作公司,全国继续教育网怎么登录?
Laravel如何实现用户密码重置功能?(完整流程代码)
香港服务器选型指南:免备案配置与高效建站方案解析
Laravel队列由Redis驱动怎么配置_Laravel Redis队列使用教程
猪八戒网站制作视频,开发一个猪八戒网站,大约需要多少?或者自己请程序员,需要什么程序员,多少程序员能完成?
悟空浏览器如何设置小说背景色_悟空浏览器背景色设置【方法】
魔方云NAT建站如何实现端口转发?
Laravel如何使用Socialite实现第三方登录?(微信/GitHub示例)
佛山企业网站制作公司有哪些,沟通100网上服务官网?
如何获取上海专业网站定制建站电话?
C#如何调用原生C++ COM对象详解
WordPress 子目录安装中正确处理脚本路径的完整指南
如何在HTML表单中获取用户输入并用JavaScript动态控制复利计算循环
小米17系列还有一款新机?主打6.9英寸大直屏和旗舰级影像
高性价比服务器租赁——企业级配置与24小时运维服务
Python正则表达式进阶教程_复杂匹配与分组替换解析
如何正确选择百度移动适配建站域名?
Laravel怎么设置路由分组Prefix_Laravel多级路由嵌套与命名空间隔离【步骤】
如何快速查询网址的建站时间与历史轨迹?
如何确保西部建站助手FTP传输的安全性?
Laravel怎么进行数据库事务处理_Laravel DB Facade事务操作确保数据一致性
如何快速生成凡客建站的专业级图册?
php 三元运算符实例详细介绍
如何在宝塔面板中修改默认建站目录?
Laravel如何记录自定义日志?(Log频道配置)
长沙做网站要多少钱,长沙国安网络怎么样?
Zeus浏览器网页版官网入口 宙斯浏览器官网在线通道
深圳网站制作平台,深圳市做网站好的公司有哪些?
laravel怎么在请求结束后执行任务(Terminable Middleware)_laravel Terminable Middleware请求结束任务执行方法
Android 常见的图片加载框架详细介绍
米侠浏览器网页图片不显示怎么办 米侠图片加载修复
Laravel如何构建RESTful API_Laravel标准化API接口开发指南
Laravel怎么配置不同环境的数据库_Laravel本地测试与生产环境动态切换【方法】
,南京靠谱的征婚网站?
微博html5版本怎么弄发语音微博_语音录制入口及时长限制操作【教程】
Laravel Eloquent关联是什么_Laravel模型一对一与一对多关系精讲
googleplay官方入口在哪里_Google Play官方商店快速入口指南
济南网站建设制作公司,室内设计网站一般都有哪些功能?
Laravel Seeder怎么填充数据_Laravel数据库填充器的使用方法与技巧
Laravel怎么使用Session存储数据_Laravel会话管理与自定义驱动配置【详解】
如何在阿里云购买域名并搭建网站?

