element 上传组件 el-upload 的经验总结

前言

最近在做后台管理项目，采用的 ，上传图片是一个很常用的功能，也遇到了很多问题，刚好趁此机会做一些总结。

初步总结下会提到的问题，目录如下：

1. el-upload 自定义上传方法
2. 图片上传到七牛云
3. 图片压缩后再上传（压缩使用 lrz）
4. el-upload 进度条不显示的问题

版本信息：

• element-ui 2.3.4
• vue 2.5.10

提示：
由于每个人做的业务不尽相同，所以文章里的代码只是起一个引导作用，提供一个思路，具体可以根据自己的需求来调整。

正文

上传图片到七牛云

这个需要前后端的配合才能实现， 是官方的 javascript sdk 参考链接。

• 在使用 js-sdk 之前，您必须先注册一个七牛帐号，并登录控制台获取一对有效的 accesskey 和 secretkey，您可以阅读和以进一步了解如何正确使用和管理密钥 。

• js-sdk 依赖服务端颁发 token，可以通过以下二种方式实现：
  1. 利用七牛服务端 sdk 构建后端服务
  2. 利用七牛底层 api 构建服务，详见七牛和

前端通过接口请求以获得 token 信息

前端需要去拿到后端生成的 token 才可以上传图片。

自定义上传，上传前可压缩

http-request 属性可以覆盖默认的上传行为，自定义上传的实现。
主要来看一下这个自定义的函数的代码实现：

// 自定义的上传实现函数
handlehttprequest(req) {
  // uid 作为唯一标识，方便上传完成后精准地替换图片 url
  const uid = req.file.uid 
  // 获取文件后缀名的函数
  const ext = getfileext(req.file.name) 
  // 自定义 key ，上传时对图片的重命名会用到
  let keyname = this.$formatdate(new date(), 'yyyymmddhhmmss') + math.floor(math.random() * 1000) + '.' + ext
  // 压缩图片
  let newfile = null
  lrz(req.file, {
    quality: 0.7
  }).then(rst => {
    // 压缩完成
    newfile = rst.file
    // 创建form对象，上传七牛云所需要的参数
    const filedata = new formdata() 
    filedata.append('file', newfile)
    filedata.append('token', this.token)
    filedata.append('key', keyname)
    const config = {
      headers: { 'content-type': 'multipart/form-data' },
      // 这一段代码解决进度条不显示的问题，属于 axios 的使用知识。具体可以看文末的参考链接。
      onuploadprogress: progressevent => {
       const percentcompleted = math.floor((progressevent.loaded * 100) / progressevent.total)
       req.onprogress({ percent: percentcompleted })
     }
    }
    // 请求七牛云的接口，具体看自己怎么配置
    // 这里的 action 是请求地址，filedata 是请求发送的内容，config 是 http 的相关配置
    // 官方的请求地址可以查看这个链接：https://developer.qiniu.com/kodo/manual/1671/region-endpoint
    axios.post($config[this.bucket].action, filedata, config).then(res => {
      const url = `${$config[this.bucket].domain}/${res.data.key}`
      // 修改 url
      this.filelist.foreach((item) => {
        if (item.uid === uid) {
          item.url = url
        }
      })
      req.onsuccess(res)
    }).catch(err => {
      req.onerror(err)
    })
  }).catch(err => {
    console.log(err)
  })
}

压缩图片

这里直接采用前人造的*，可以设置压缩比例和图片的尺寸限制。

想看更多细节的话地址在 这里 ，上面代码里也有用到，但是这个*作者已经不再维护了。

el-upload 进度条不显示

使用自定义上传后，我发现 el-upload 自带的进度条显示失效了，这个问题查找了比较久，一开始一直不知道应该在哪里去监听 progress 事件。

参考链接里的顺序就是我思考的顺序。

先是去查了下官方的 issue ，意识到是监听 process 的问题，然后就想 axios 是不是有相关的设置呢？毕竟我这里是用 axios 发请求的，所以又谷歌直接搜关键词「axios upload progress」，找到了一些相关的信息，就是在 config 里去配置 onuploadprogress 函数，具体代码见上面的例子。

参考链接：

1. upload组件的 http:request 怎么获取进度值

（完）