Vue中关于ElementUI上传组件Upload的整理_element-ui upload slot default file

一、概要

ElementUI为我们提供了上传组件Upload：（以下功能 ElementUI官网 均有演示）

• 可以使用 drag 设置点击或者拖拽上传文件。
• 可以通过 slot 自定义的上传按钮类型和文字提示。
• 可以通过 limit 和 on-exceed 限制上传文件的个数和定义超出限制时的行为
• 可以通过 before-remove 来阻止文件移除操作。
• 可以通过 before-upload 限制用户上传的图片格式和大小。
• 可以使用 list-type 属性来设置文件列表的样式。
• 可以使用 scoped-slot 去设置缩略图模版。
• 可以通过 on-change 钩子函数来对列表进行控制。
• 可以使用 scoped-slot 去设置缩略图模版。

二、功能梳理

要想学会一个组件怎么使用，首先要了解它的组成，一个组件的组成无非四种类型：
属性（Attribute）、方法（Methods）、事件（Event）、插槽（Slot）。

1、Attribute

• 关于上传的一些请求属性

• 关于上传的一些配置属性

• 关于上传的一些钩子属性

2、Methods

3、Slot

三、代码示例

• template

  <div>
    <el-upload
      ref="upload"
      :action="action"
      :name="name"
      :headers="headers"
      :data="data"
      :with-credentials="withCredentials"
      :accept="accept"
      :multiple="multiple"
      :limit="limit"
      :show-file-list="showFileList"
      :file-list="fileList"
      :list-type="listType"
      :drag="drag"
      :auto-upload="autoUpload"
      :disabled="disabled"
      :on-preview="handlePreview"
      :before-remove="beforeRemove"
      :on-remove="handleRemove"
      :before-upload="beforeUpload"
      :on-progress="handleProgress"
      :on-success="handleSuccess"
      :on-error="handleError"
      :on-change="handleChange"
      :on-exceed="handleExceed"
    >
      <el-button size="small" type="primary">点击上传</el-button>
      <div slot="trigger">触发文件选择框的内容</div>
      <div slot="tip" class="el-upload__tip">提示说明文字（例如：只能上传jpg/png文件，且不超过500kb</div>
    </el-upload>
    <el-upload :http-request="httpRequest" />
    <el-button size="small" type="primary" @click="emitMethods">实例方法</el-button>
  </div>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34

• javascript

export default {
  name: 'Demo',
  data() {
    return {
      action: '', // 请求地址
      name: 'file', // 请求字段名
      headers: {}, // 请求头
      data: {}, // 请求额外参数
      withCredentials: false, // 支持发送 cookie 凭证信息
      accept: '', // 接受上传的文件类型
      multiple: true, // 是否支持多选文件
      limit: 3, // 最大允许上传个数
      showFileList: true, // 是否显示已上传文件列表
      fileList: [], // 上传的文件列表, 例如: [{name: ‘food.jpg’, url: ‘https://xxx.cdn.com/xxx.jpg’}]
      listType: 'text', // 文件列表的类型（text/picture/picture-card）
      drag: false, // 是否启用拖拽上传
      autoUpload: true, // 是否在选取文件后立即进行上传
      disabled: true // 是否禁用

    }
  },
  methods: {
    // 覆盖默认的上传行为
    httpRequest() {
      // 可以自定义上传的实现
    },
    // 点击文件列表中已上传的文件时的钩子
    handlePreview(file) {
      console.log(file)
    },
    // 删除文件之前的钩子，参数为上传的文件和文件列表，若返回 false 或者返回 Promise 且被 reject，则停止删除。
    beforeRemove(file, fileList) {
      console.log(file, fileList)
      return this.$confirm(`确定移除 ${file.name}？`)
    },
    // 文件列表移除文件时的钩子
    handleRemove(file, fileList) {
      console.log(file, fileList)
    },
    // 上传文件之前的钩子，参数为上传的文件，若返回 false 或者返回 Promise 且被 reject，则停止上传。
    beforeUpload(file) {
      console.log(file)
    },
    // 文件上传时的钩子
    handleProgress(event, file, fileList) {
      console.log(event, file, fileList)
    },
    // 文件上传成功时的钩子
    handleSuccess(response, file, fileList) {
      console.log(response, file, fileList)
      this.$message.success('上传成功！')
    },
    // 文件上传失败时的钩子
    handleError(err, file, fileList) {
      console.log(err, file, fileList)
      this.$message.error('上传失败！')
    },
    // 文件状态改变时的钩子，添加文件、上传成功和上传失败时都会被调用
    handleChange(file, fileList) {
      console.log(file, fileList)
    },
    // 文件状态改变时的钩子，添加文件、上传成功和上传失败时都会被调用
    handleExceed(files, fileList) {
      this.$message.warning(`当前限制选择 3 个文件，本次选择了 ${files.length} 个文件，共选择了 ${files.length + fileList.length} 个文件`)
    },
    // 实例方法
    emitMethods() {
      // 清空已上传的文件列表（该方法不支持在 before-upload 中调用）
      this.$refs.upload.clearFiles()
      // 取消上传请求,参数：（ file: fileList 中的 file 对象 ）
      this.$refs.upload.abort()
      // 手动上传文件列表
      this.$refs.upload.submit()
    }
  }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76

参考文档

• ElementUI官网：https://element.eleme.cn/#/zh-CN/component/upload