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会话管理与自定义驱动配置【详解】  如何在阿里云购买域名并搭建网站?