element/examples/docs/zh-CN/upload.md

Upload 上传

通过点击或者拖拽上传文件

点击上传多个文件

::: demo 通过 slot 你可以传入自定义的上传按钮类型和文字提示。

<el-upload
  action="//jsonplaceholder.typicode.com/posts/"
  :on-preview="handlePreview"
  :on-remove="handleRemove"
  :default-file-list="fileList">
  <el-button size="small" type="primary">点击上传</el-button>
  <div class="el-upload__tip" slot="tip">只能上传jpg/png文件，且不超过500kb</div>
</el-upload>
<script>
  export default {
    data() {
      return {
        fileList: [{name: 'food.jpeg', url: 'https://fuss10.elemecdn.com/3/63/4e7f3a15429bfda99bce42a18cdd1jpeg.jpeg?imageMogr2/thumbnail/360x360/format/webp/quality/100'}, {name: 'food2.jpeg', url: 'https://fuss10.elemecdn.com/3/63/4e7f3a15429bfda99bce42a18cdd1jpeg.jpeg?imageMogr2/thumbnail/360x360/format/webp/quality/100'}]
      };
    },
    methods: {
      handleRemove(file, fileList) {
        console.log(file, fileList);
      },
      handlePreview(file) {
        console.log(file);
      }
    }
  }
</script>

:::

拖拽上传

可将文件拖入指定区域进行上传。

::: demo 将 type 属性指定为 'drag' 可以将上传控件变为支持拖拽的形式，并且你可以通过 multiple 属性来控制是否支持多选，on-preview 和 on-remove 是一个钩子函数，分别在点击上传后的文件链接和点击移除上传后的文件后被调用。

<el-upload
  action="//jsonplaceholder.typicode.com/posts/"
  type="drag"
  :multiple="true"
  :on-preview="handlePreview"
  :on-remove="handleRemove"
  :on-success="handleSuccess"
  :on-error="handleError"
  :default-file-list="fileList"
>
  <i class="el-icon-upload"></i>
  <div class="el-dragger__text">将文件拖到此处，或<em>点击上传</em></div>
  <div class="el-upload__tip" slot="tip">只能上传jpg/png文件，且不超过500kb</div>
</el-upload>
<script>
  export default {
    data() {
      return {
        fileList: [{name: 'food.jpeg', url: 'https://fuss10.elemecdn.com/3/63/4e7f3a15429bfda99bce42a18cdd1jpeg.jpeg?imageMogr2/thumbnail/360x360/format/webp/quality/100'}, {name: 'food2.jpeg', url: 'https://fuss10.elemecdn.com/3/63/4e7f3a15429bfda99bce42a18cdd1jpeg.jpeg?imageMogr2/thumbnail/360x360/format/webp/quality/100'}]
      };
    },
    methods: {
      handleRemove(file, fileList) {
        console.log(file, fileList);
      },
      handlePreview(file) {
        console.log(file);
      }
    }
  }
</script>

:::

上传单个图片

专门针对图片类型文件的上传，上传后在原位置显示缩略图。

::: demo thumbnail-mode 属性允许你将上传组件强制只允许图片上传，并支持展示上传文件的缩略图。

<el-upload
  action="//jsonplaceholder.typicode.com/posts/"
  type="drag"
  :thumbnail-mode="true"
  :on-preview="handlePreview"
  :on-remove="handleRemove"
  :default-file-list="fileList"
>
  <i class="el-icon-upload"></i>
  <div class="el-dragger__text">将文件拖到此处，或<em>点击上传</em></div>
  <div class="el-upload__tip" slot="tip">只能上传jpg/png文件，且不超过500kb</div>
</el-upload>
<script>
  export default {
    data() {
      return {
        fileList: [{name: 'food.jpeg', url: 'https://fuss10.elemecdn.com/3/63/4e7f3a15429bfda99bce42a18cdd1jpeg.jpeg?imageMogr2/thumbnail/360x360/format/webp/quality/100'}, {name: 'food2.jpeg', url: 'https://fuss10.elemecdn.com/3/63/4e7f3a15429bfda99bce42a18cdd1jpeg.jpeg?imageMogr2/thumbnail/360x360/format/webp/quality/100'}]
      };
    },
    methods: {
      handleRemove(file, fileList) {
        console.log(file, fileList);
      },
      handlePreview(file) {
        console.log(file);
      }
    }
  }
</script>

:::

Attribute

参数	说明	类型	可选值	默认值
action	必选参数, 上传的地址	string	—	—
headers	可选参数, 设置上传的请求头部	object	—	—
multiple	可选参数, 是否支持多选文件	boolean	—	—
data	可选参数, 上传时附带的额外参数	object	—	—
name	可选参数, 上传的文件字段名	string	—	file
with-credentials	支持发送 cookie 凭证信息	boolean	—	false
show-upload-list	是否显示已上传文件列表	boolean	—	true
type	上传控件类型	string	select,drag	select
accept	可选参数, 接受上传的文件类型（thumbnail-mode 模式下此参数无效）	string	—	—
on-preview	可选参数, 点击已上传的文件链接时的钩子, 可以通过 file.response 拿到服务端返回数据	function(file)	—	—
on-remove	可选参数, 文件列表移除文件时的钩子	function(file, fileList)	—	—
on-success	可选参数, 文件上传成功时的钩子	function(response, file, fileList)	—	—
on-error	可选参数, 文件上传失败时的钩子	function(err, response, file)	—	—
on-progress	可选参数, 文件上传时的钩子	function(event, file, fileList)	—	—
before-upload	可选参数, 上传文件之前的钩子，参数为上传的文件，若返回 false 或者 Promise 则停止上传。	function(file)	—	—
thumbnail-mode	是否设置为图片模式，该模式下会显示图片缩略图	boolean	—	false
default-file-list	默认已上传的文件列表, 例如: [{name: 'food.jpeg', url: 'https://fuss10.elemecdn.com/3/63/4e7f3a15429bfda99bce42a18cdd1jpeg.jpeg?imageMogr2/thumbnail/360x360/format/webp/quality/100'}]	array	—	[]

Methods

方法名	说明	参数
clearFiles	清空已上传的文件列表	—