Element—el-upload文件上传封装

汪叽家的兔子羡2025-07-30 10:56

Element---el-upload文件上传封装

一、描述

常见两种文件上传：

1.文件上传列表

2.文件上传+模板下载

二、封装

1.文件上传

1.1 效果图
1.2 组件代码实现
xml 复制代码 
<template>
  <div class="upload-file">
    <el-upload multiple :action="uploadFileUrl" :disabled="disabled" :before-upload="handleBeforeUpload"
      :file-list="fileList" :limit="limit" :on-error="handleUploadError" :on-exceed="handleExceed"
      :on-success="handleUploadSuccess" :show-file-list="false" class="upload-file-uploader" ref="fileUpload">
      <!-- 上传按钮 -->
      <el-button size="mini" type="primary" :disabled="disabled">选取文件</el-button>
      <!-- 上传提示 -->
      <div class="el-upload__tip" slot="tip" v-if="showTip">
        请上传
        <template v-if="fileSize">
          大小不超过 <b style="color: #f56c6c">{{ fileSize }}MB</b>
        </template>
        <template v-if="fileType">
          格式为 <b style="color: #f56c6c">{{ fileType.join("/") }}</b>
        </template>
        的文件
      </div>
    </el-upload>

    <!-- 文件列表 -->
    <transition-group class="upload-file-list el-upload-list el-upload-list--text" name="el-fade-in-linear" tag="ul">

      <li :key="file.fileUrl" class="el-upload-list__item ele-upload-list__item-content"
        v-for="(file, index) in fileList">
        <el-link
          :href="`${baseUrl}?id=${file.fileFastId}`"
          :underline="false"
          target="_blank"
        >
          <span class="el-icon-document"> {{ file.fileName }} </span>
        </el-link>
        <div class="ele-upload-list__item-content-action">
          <el-link :underline="false" @click="handleDelete(index)" :disabled="disabled" type="danger">删除</el-link>
        </div>
      </li>
    </transition-group>
  </div>
</template>

<script>
import { getToken } from "@/utils/auth";

export default {
  name: "FileUploadCenter",
  props: {
    // 值
    value: [String, Object, Array],
    // 数量限制
    limit: {
      type: Number,
      default: 5,
    },
    // 大小限制(MB)
    fileSize: {
      type: Number,
      default: 5,
    },
    // 文件类型, 例如['png', 'jpg', 'jpeg']
    fileType: {
      type: Array,
      default: () => ["doc", "xls", "ppt", "txt", "pdf",'png', 'jpg', 'jpeg','docx','xlsx','pptx'],
      
    },
    // 是否显示提示
    isShowTip: {
      type: Boolean,
      default: true,
    },
    // 是否禁用
    disabled: {
      type: Boolean,
      default: false,
    }
  },
  data() {
    return {
      number: 0,
      uploadList: [],
      // baseUrl: '/sy-sy',
      baseUrl: "https://sy.sy.com/document-center/fastdfs/download",
      uploadFileUrl:
      // drp-file在代理配置中进行了地址代理
        process.env.NODE_ENV == "development"
          ? "/drp-file/document-center/fastdfs/upload"
          : "/document-center/fastdfs/upload",
      headers: {
        Authorization: "Bearer " + getToken(),
      },
      fileList: [],
    };
  },
  watch: {
    value: {
      handler(val) {
        this.fileList = val ? val : [];

        return this.fileList;
        // if (val) {
        //   let temp = 1;
        //   // 首先将值转为数组
        //   const list = Array.isArray(val) ? val : this.value.split(",");
        //   console.log("list", list);
        //   // 然后将数组转为对象数组
        //   this.fileList = list.map((item) => {
        //     if (typeof item === "string") {
        //       item = { name: item, url: item };
        //     }
        //     item.uid = item.uid || new Date().getTime() + temp++;
        //     return item;
        //   });
        // } else {
        //   this.fileList = [];
        //   return [];
        // }
      },
      deep: true,
      immediate: true,
    },
  },
  computed: {
    // 是否显示提示
    showTip() {
      return this.isShowTip && (this.fileType || this.fileSize);
    },
  },
  methods: {
    // 上传前校检格式和大小
    handleBeforeUpload(file) {
      // 校检文件类型
      if (this.fileType) {
        const fileName = file.name.split(".");
        const fileExt = fileName[fileName.length - 1];
        const isTypeOk = this.fileType.indexOf(fileExt) >= 0;
        if (!isTypeOk) {
          this.$modal.msgError(
            `文件格式不正确, 请上传${this.fileType.join("/")}格式文件!`
          );
          return false;
        }
      }
      // 校检文件大小
      if (this.fileSize) {
        const isLt = file.size / 1024 / 1024 < this.fileSize;
        if (!isLt) {
          this.$modal.msgError(`上传文件大小不能超过 ${this.fileSize} MB!`);
          return false;
        }
      }
      this.$modal.loading("正在上传文件，请稍候...");
      this.number++;
      return true;
    },
    // 文件个数超出
    handleExceed() {
      this.$modal.msgError(`上传文件数量不能超过 ${this.limit} 个!`);
    },
    // 上传失败
    handleUploadError(err) {
      this.$modal.msgError("上传文件失败，请重试");
      this.$modal.closeLoading();
    },
    // 上传成功回调
    handleUploadSuccess(res, file) {
      if (res.code == 200) {
        console.log(res, 'res--------------');
        this.uploadList.push({
          fileName: res.filename,
          fileUrl: `/${res.group}/${res.filepath}`,
          fileFastId: res.id,
        });
        this.uploadedSuccessfully();
      } else {
        this.number--;
        this.$modal.closeLoading();
        this.$modal.msgError(res.msg);
        this.$refs.fileUpload.handleRemove(file);
        this.uploadedSuccessfully();
      }
    },
    // 删除文件
    handleDelete(index) {
      this.fileList.splice(index, 1);
      // this.$emit("input", this.listToString(this.fileList));
      this.$emit("input", this.fileList);
    },
    // 上传结束处理
    uploadedSuccessfully() {
      if (this.number > 0 && this.uploadList.length === this.number) {
        this.fileList = this.fileList.concat(this.uploadList);
        console.log(this.fileList, 'this.fileList***************');
        this.uploadList = [];
        this.number = 0;
        // this.$emit("input", this.listToString(this.fileList));
        this.$emit("input", this.fileList);
        this.$modal.closeLoading();
      }
    },
    // 获取文件名称
    // getFileName(name) {
    //   if (name.lastIndexOf("/") > -1) {
    //     return name.slice(name.lastIndexOf("/") + 1);
    //   } else {
    //     return "";
    //   }
    // },
    // 对象转成指定字符串分隔
    // listToString(list, separator) {
    //   let strs = "";
    //   separator = separator || ",";
    //   for (let i in list) {
    //     strs += list[i].url + separator;
    //   }
    //   return strs != "" ? strs.substr(0, strs.length - 1) : "";
    // },
  },
};
</script>


<style scoped lang="scss">
.upload-file-uploader {
  margin-bottom: 5px;
}

.upload-file-list .el-upload-list__item {
  border: 1px solid #e4e7ed;
  line-height: 2;
  margin-bottom: 10px;
  position: relative;
}

.upload-file-list .ele-upload-list__item-content {
  display: flex;
  justify-content: space-between;
  align-items: center;
  color: inherit;
}

.ele-upload-list__item-content-action .el-link {
  margin-right: 10px;
}
</style>
1.3 组件使用
xml 复制代码 
// 引入
// 使用
<file-upload-center
  v-model="fileList"
  :file-type="['png', 'jpg', 'jpeg']"
></file-upload-center>

2、文件上传+模板下载

2.1 效果图
2.2 组件代码实现
xml 复制代码 
<script>
export default {
  name:'BatchImport',
  props:{
    disabled:{
      type:Boolean,
      default:false,
    },
    limit:{
      type:Number,
      default:1,
    },
    fileType:{
      type:Array,
      default:()=>['xls', 'xlsx'],
    },
    size:{
      type:String,
      default:'mini',
    },
    isShowTip:{
      type:Boolean,
      default:true,
    },
    isTemplate:{
      type:Boolean,
      default:true,
    },
    fileSize: {
      type: Number,
      default: 100,
    },
  },
  computed:{
     // 是否显示提示
     showTip() {
      return this.isShowTip && (this.fileType || this.fileSize);
    },
    accept(){
      return this.fileType.map(item =>(`.${item}`)).join(',');
    }
  },
  data(){
    return {
      title:'批量导入',
      visible:false,
      loading:false,
      fileList:[],
      number: 0,

    }
  },
  methods:{
    // 确认上传
    async submitUpload(){
      if(this.fileList.length){
        this.$emit('import',this.fileList);
      }else{
      this.$notify.warning({
        title:'警告',
        message: '请上传文件之后在确认！',
      });

      }
      
    },
    // 模板下载
    async templateDownload(){
      this.$emit('temDownload')
      // 放父组件
      // this.download('/system/material/download', {}, `物料基本信息模板.xlsx`);
    },
    // 
    beforeClose(done){
      this.fileList = [];
      // 关闭前清空
      done();
    },
    // 预览
    handlePreview(){},
    // 移除
    handleRemove(file, fileList){
      this.fileList = fileList;
    },
    // 文件改变
    onChange(file, fileList){
      this.fileList = fileList;
    },
    setVisible(prop){
      this.visible = prop;
      if(!prop){
        this.fileList = [];
      }
    },
    open(){
      this.setVisible(true);
    },
    // 取消
    cancal(){
      this.setVisible(false);
    },
     // 上传前校检格式和大小
     handleBeforeUpload(file) {
      // 校检文件类型
      if (this.fileType) {
        const fileName = file.name.split(".");
        const fileExt = fileName[fileName.length - 1];
        const isTypeOk = this.fileType.indexOf(fileExt) >= 0;
        if (!isTypeOk) {
          this.$modal.msgError(
            `文件格式不正确, 请上传${this.fileType.join("/")}格式文件!`
          );
          return false;
        }
      }
      // 校检文件大小
      if (this.fileSize) {
        const isLt = file.size / 1024 / 1024 < this.fileSize;
        if (!isLt) {
          this.$modal.msgError(`上传文件大小不能超过 ${this.fileSize} MB!`);
          return false;
        }
      }
      this.$modal.loading("正在上传文件，请稍候...");
      this.number++;
      return true;
    },
    
  },
  created(){},
}
</script>

<template>
  <el-button 
    :disabled="disabled"
    :size="size"
    @click="open"
    type="primary"
    v-bind="$attrs"
    v-on="$listeners"
  >
    {{ title }}
    <el-dialog 
      :title="title" 
      :visible.sync="visible"
      v-loading="loading"
      width="35%" 
      center
      :before-close="beforeClose"
      append-to-body
    >
      <el-upload
        ref="upload"
        action="#"
        :on-preview="handlePreview"
        :accept="accept"
        :before-upload="handleBeforeUpload"
        :on-remove="handleRemove"
        :file-list="fileList"
        :auto-upload="false"
        :on-change="onChange" 
        :limit="limit"
        :disabled="disabled"
        style="text-align: center;"
      >
        <el-button 
          slot="trigger" 
          :size="size" 
          type="primary"
        >选取文件</el-button>
        <el-button
          v-if="isTemplate"
          style="margin-left: 10px;" 
          :size="size" 
          type="success" 
          @click="templateDownload"
        >下载模板</el-button>
        <div slot="tip" class="el-upload__tip" v-if="isShowTip">
          请上传
          <template v-if="fileSize">
            大小不超过 <b style="color: #f56c6c">{{ fileSize }}MB</b>
          </template>
          <template v-if="fileType">
            格式为 <b style="color: #f56c6c">{{ fileType.join("/") }}</b>
          </template>
        </div>
      </el-upload>

      <div slot="footer" class="dialog-footer">
        <el-button type="primary" @click="submitUpload" :size="size">确 定</el-button>
        <el-button @click="cancal" :size="size">取 消</el-button>
      </div>
    </el-dialog>
  </el-button>
</template>
2.3 组件使用
xml 复制代码 
<BatchImport
  ref="batchImport"
  @import="handelImport"
  @temDownload="handleTemDownload"
  :fileSize="2"
></BatchImport>
// @import 导入方法
// @temDownload 模板下载方法
热门推荐
01Qwen3-Coder 快速上手教程 | Qwen Code + Claude Code02全球最强模型Grok4，国内已可免费使用！（附教程）03MSPM0G3507——读取引脚的高低电平方法（数字信号循迹模块）04Coze 开源了，送上保姆级私有化部署方案【建议收藏】05腾讯还是太全面了，限时免费！超全CodeBuddy IDE保姆级教程！（附案例）06扣子开源本地部署教程 丨Coze智能体小白喂饭级指南07KGG转MP3工具|非KGM文件|解密音频08【手把手攻略】国家育儿补贴正式开领！一键算清你能拿多少钱？附补贴领取计算器09coze 开源版本地部署及踩过的坑【喂饭级教程】10机器学习——多项式回归算法