<el-upload :action="uploadActionUrl">
<el-button size="small" type="primary">点击上传</el-button>
</el-upload>
1 :action是执行上传动作的后台接口
参数 | 说明 | 类型 | 可选值 | 默认值 |
---|---|---|---|---|
action | 必选参数,上传的地址 | string | — | — |
如果不想使用默认的上传行为 可以使用http-request 自定义上传
http-request | 覆盖默认的上传行为,可以自定义上传的实现 | function | — | — |
2 上传文件数量 multiple
(1)首先是设置多个上传的文件是否可以同时选中 这个也是<input type = 'file'>的属性 添加multiple即可
(2)另外 limit属性用来设置最多可以上传的文件数量 超出此数量后选择的文件是不会被上传的
on-exceed绑定的方法是用力啊处理文件超出限制时的钩子
on-exceed | 文件超出个数限制时的钩子 | function(files, fileList) | — | - |
<el-upload
:action="uploadActionUrl"
multiple
:limit="3"
:on-exceed="handleExceed">
<el-button size="small" type="primary">点击上传</el-button>
</el-upload>
3 上传格式及限制大小
(1)如果需要限制上传文件的格式, 需要添加属性 这个是直接使用<input type='file'> 一样的属性了, accept属性值可以是accept="image/gif, image/jpeg, text/plain, application/pdf" 等等,
文件格式的提示,则可以使用slot。
accept | 接受上传的文件类型(thumbnail-mode【缩略图】 模式下此参数无效 ) | string | — | — |
<el-upload
:action="uploadActionUrl"
accept="image/jpeg,image/gif,image/png"
multiple
:limit="3"
:on-exceed="handleExceed">
<el-button size="small" type="primary">点击上传</el-button>
<div slot="tip" class="el-upload__tip">请上传图片格式文件</div>
</el-upload>
(2)另外 这里只是选择文件时限制格式 其实用户还是可以点选全部文件 上传其他格式 如果需要在再上传时再次校验,则需要在before-upload这个钩子绑定相应的方法
before-upload | 上传文件之前的钩子,参数为上传的文件,若返回 false 或者返回 Promise 且被 reject,则停止上传。 | function(file) | — | — |
<el-upload
:action="uploadActionUrl"
accept="image/jpeg,image/gif,image/png"
:before-upload="onBeforeUpload"
multiple
:limit="3"
:on-exceed="handleExceed">
<el-button size="small" type="primary">点击上传</el-button>
<div slot="tip" class="el-upload__tip">请上传图片格式文件</div>
</el-upload>
...
onBeforeUpload(file)
{
const isIMAGE = file.type === 'image/jpeg'||'image/gif'||'image/png';
const isLt1M = file.size / 1024 / 1024 < 1;
if (!isIMAGE) {
this.$message.error('上传文件只能是图片格式!');
}
if (!isLt1M) {
this.$message.error('上传文件大小不能超过 1MB!');
}
return isIMAGE && isLt1M;
}
这种在限制文件格式的同时 也做了文件大小的校验
4 显示已经上传文件列表
(1)这个功能可以很清晰的显示已经上传的文件列表 并且可以方便删除 以便上传新的文件
<el-upload
:action="uploadActionUrl"
accept="image/jpeg,image/gif,image/png"
multiple
:limit="3"
:on-exceed="handleExceed"
:on-error="uploadError"
:on-success="uploadSuccess"
:on-remove="onRemoveTxt"
:before-upload="onBeforeUpload"
:file-list="files">
<el-button size="small" type="primary">点击上传</el-button>
<div slot="tip" class="el-upload__tip">请上传图片格式文件</div>
</el-upload>
实现方法就是 flie-list='files'这个属性的添加 其中files时绑定的数组对象 初始为空
效果图如下
5 上传时提交数据
(1)上传文件时同时需要提交数据给后台接口 这时就要用到 :data 属性
data | 上传时附带的额外参数 | object | — | — |
<el-upload
:action="uploadActionUrl"
accept="image/jpeg,image/gif,image/png"
:data="uploadData"
multiple
:limit="3"
:on-exceed="handleExceed"
:on-error="uploadError"
:on-success="uploadSuccess"
:on-remove="onRemoveTxt"
:before-upload="onBeforeUpload"
:file-list="files">
<el-button size="small" type="primary">点击上传</el-button>
<div slot="tip" class="el-upload__tip">请上传图片格式文件</div>
</el-upload>
...
uploadData: {
dataType: "0",
oldFilePath:""
}
5 选取和上传分开处理
(1)有时候我们需要把选取和上传分开处理,比如上传图片,先选取文件提交给前端 ,图片处理后再把base64内容提交给后台
<el-upload
action=""
accept="image/jpeg,image/png"
:on-change="onUploadChange"
:auto-upload="false"
:show-file-list="false">
<el-button slot="trigger" size="small" type="primary">选取</el-button>
<el-button style="margin-left: 10px;" size="small" type="success" @click="submitUpload">上传</el-button>
<div slot="tip" class="el-upload__tip">只能上传jpg/png文件,且不能超过1m</div>
</el-upload>
...
submitUpload()
{
console.log("submit")
},
onUploadChange(file)
{
const isIMAGE = (file.raw.type === 'image/jpeg' || file.raw.type === 'image/png');
const isLt1M = file.size / 1024 / 1024 < 1;
if (!isIMAGE) {
this.$message.error('只能上传jpg/png图片!');
return false;
}
if (!isLt1M) {
this.$message.error('上传文件大小不能超过 1MB!');
return false;
}
var reader = new FileReader();
reader.readAsDataURL(file.raw);
reader.onload = function(e){
console.log(this.result)//图片的base64数据
}
}