首頁 >web前端 >Vue.js >vue3如何使用el-upload上傳文件

vue3如何使用el-upload上傳文件

WBOY
WBOY轉載
2023-05-15 21:31:043439瀏覽

el-upload上傳檔案

在專案開發的過程中上傳檔案的需求是經常會遇到的,這篇文章我們就詳細介紹使用elementplus中el-upload來上傳檔案了。

我們先來看看el-upload可以設定哪些屬性和事件。

屬性

  • action: 請求url

  • #headers: 設定上傳的請求頭部

  • method: 設定上傳請求方法

  • multiple: 是否支援多重選取檔案

  • data: 上傳時附帶的額外參數

  • name: 上傳的檔案欄位名稱

  • #with-credentials: 支援傳送cookie憑證資訊

#以上這些參數都是採用action的預設方式請求時使用的,如果我們使用自訂的請求方法,這些屬性基本上都不會使用到。

  • show-file-list: 是否顯示已上傳檔案清單

  • #drag: 是否啟用拖曳上傳

  • accept: 接受上傳的檔案類型

  • on-preview: 點選檔案清單中已上傳檔案時的鉤子

  • on-remove: 檔案清單移除檔案時的鉤子

  • on-success: 檔案上傳成功時的鉤子

  • on-error:檔案上傳失敗時的鉤子

  • on-progress: 檔案上傳時的鉤子

  • on-change: 檔案狀態改變時的鉤子,添加,上傳成功和失敗都會被呼叫

  • on-exceed: 當超出限制時執行的鉤子

  • before-upload: 檔案上傳先前的鉤子,參數為上傳的文件, 若返回false或返回 Promise 且被reject,則停止上傳。

  • before-remove: 刪除檔案之前的鉤子,參數為上傳的檔案和檔案列表, 若返回false 或返回Promise 且被reject,則停止刪除。

  • file-list/v-model:file-list: 預設上傳檔案

  • list-type: 檔案清單的類型,'text ' | 'picture' | 'picture-card'。

  • auto-upload: 是否自動上傳檔案

  • #http-request: 覆寫預設的Xhr 行為,允許自行實作上傳檔案的請求

  • disabled: 是否停用上傳

  • #limit: 允許上傳檔案的最大數量

方法

  • abort: 取消上傳要求

  • submit: 手動上傳檔案清單

  • clearFiles: 清除已上傳的檔案清單(該方法不支援在 before-upload 中呼叫)

  • handleStart: 手動選擇檔案

#handleRemove: 手動移除檔案。

file

rawFile

已合併。

上傳圖片的實作

上傳圖片的時候我們一般都會重寫http請求,不使用預設的action去請求,因此action我們一般都會設定成&lsquo ;#’。

<template>
  <div>
    <el-upload
      action="#"
      :headers="headers"
      :list-type="listType"
      :http-request="uploadAction"
      :on-exceed="handleExceed"
      :on-remove="handleRemove"
      :before-upload="beforeUpload"
      :on-success="uploadSuccess"
      :on-error="uploadError"
      :on-progress="uploadProgress"
      :file-list="fileListCopy.data"
      ref="upload"
      :multiple="true"
      :limit=&#39;limit&#39;
      :disabled="disabled"
      :data="paramData"
    >
    <el-icon><Plus /></el-icon>
    <template #file="{ file }">
      <div>
        <img :src="file.url" alt="" />
        <span class="el-upload-list__item-actions">
          <span
            class="el-upload-list__item-preview"
            @click="handlePictureCardPreview(file)"
          >
            <el-icon><zoom-in /></el-icon>
          </span>
          <span
            class="el-upload-list__item-delete"
            @click="handleRemove(file)"
          >
            <el-icon><Delete /></el-icon>
          </span>
        </span>
      </div>
    </template>
    </el-upload>
    <el-dialog v-model="previewVisible">
      <img w-full :src="dialogImageUrl" alt="Preview Image" />
    </el-dialog>
  </div>
</template>
<script>
export default {
  name: &#39;uploadImg&#39;
}
</script>
<script setup>
import { Delete, Plus, ZoomIn } from &#39;@element-plus/icons-vue&#39;;
import { reactive, ref, defineProps, defineEmits, computed, getCurrentInstance } from &#39;vue&#39;;
import { ElMessage } from &#39;element-plus&#39;;
const props = defineProps({
  // 允许上传文件件的最大数量
  limit:{
    type:Number
  },
  // 是否禁用上传
  disabled:{
    type:Boolean,
    default:false
  },
  // 文件列表类型
  listType:{
    type:String,
    default:&#39;picture-card&#39;
  },
  // 上传时携带的额外参数
  paramData: {
    type:String
  }
});
const emits = defineEmits([]);
const cns = getCurrentInstance();
const globObj = cns.appContext.config.globalProperties;
const previewVisible = ref(false);
const dialogImageUrl = ref(&#39;&#39;);
const fileListCopy = reactive({
  data: []
});
const onece = ref(false);
const myChangeFile = ref(&#39;&#39;);
const changeFileIndex = ref(-1);
const uploadImgArr = reactive({
  data: []
});
const headers = reactive({});
// 预览大图
const handlePictureCardPreview = (uploadFile) => {
  dialogImageUrl.value = uploadFile.url;
  previewVisible.value = true;
};
// 移除图片
const handleRemove = (file, fileList) => {
  console.log(&#39;handleRemove&#39;, handleRemove);
  console.log(&#39;file&#39;, file);
  console.log(&#39;fileList&#39;, fileList);
  fileListCopy.data = fileListCopy.data.filter(v => v.uid !== file.uid);
};
// 文件上传数量限制
const handleExceed = (files, fileList) => {
  if (props.limit) {
    ElMessage.error(`只能上传${props.limit}张图片`);
  }
  console.log(&#39;handleExceed&#39;, handleExceed);
  console.log(&#39;files&#39;, files);
  console.log(&#39;fileList&#39;, fileList);
};
// 上传请求
const uploadAction = (option) => {
  let formData = new FormData();
  const url = &#39;&#39;;
  globObj.$axios({
    url: url,
    method: &#39;post&#39;,
    transformRequest: [function(data, headers) {
      // 去除post请求默认的Content-Type
      delete headers[&#39;Content-Type&#39;]
      return data
    }],
    data: formData,
    timeout: 300000
  }).then(res => {
    ElMessage.success(&#39;资产添加成功&#39;);
  }).catch((err) => {
    console.log(err);
  });
}
// 格式大小的限制
const beforeUpload = (file) => {
  let isJPG = false,
  fileType = file.type.split(&#39;/&#39;)[0];
  if(file.type === "image/jpeg" || file.type === "image/png") {
    isJPG = true;
  } else {
    isJPG = false;
  }
  const isLt2M = file.size / 1024 / 1024;
  if (fileType != &#39;image&#39; || isLt2M > 2) {
    ElMessage.error("请上传2M以内的图片文件!");
    return false
  }
  return true;
};
// 文件上传成功时的钩子
const uploadSuccess = (response, file, fileList) => {
  // 上传成功之后后台返回的数据
  console.log(&#39;uploadSuccess&#39;, uploadSuccess);
};
const uploadProgress = (e, file, fileList) => {
  console.log(&#39;uploadProgress&#39;, uploadProgress)
};
const uploadError = (err, file, fileList) => {
  console.log(&#39;uploadError&#39;, uploadError);
};
</script>

存在的坑

一般上傳檔案的話請求頭中的Content-Type: multipart/form-data;我們的需求中還需要設定檔案的隨機數,因此請求頭需要是這樣的Content-Type: multipart/form-data; boundary=----WebKitFormBoundarypzSlbADtTRuFx5FC。 ######下面是我遇到的問題。 ######問題1######設定了Content-Type: multipart/form-data;此時請求一直沒有隨機數boundary=----WebKitFormBoundarypzSlbADtTRuFx5FC。 ######如果設定了全域的content-type,會發現上傳介面設定multipart/form-data是不起作用的,因為沒有Boundary,所以上傳必定失敗,伺服器500。 ######接著嘗試手動新增Boundary,這次錯誤變400了######問題2######後來透過查詢資料,說不用設定Content-Type: multipart/form-data;只要參數是formData形式,瀏覽器就會自動將請求頭的Content-Type轉成Content-Type: multipart/form-data; boundary=----WebKitFormBoundarypzSlbADtTRuFx5FC。 ######但是我不設定的話就是預設的application/json。 ######於是查閱資料發現axios的transformRequest屬性可以在向伺服器發送請求數據之前修改請求數據,因為我們的請求在默認的post請求方式時Content-Type的值是application/json,需要去掉默認的值,這樣瀏覽器就可以自動加入了。 ###
  globObj.$axios({
    url: url,
    method: &#39;post&#39;,
    transformRequest: [function(data, headers) {
      // 去除post请求默认的Content-Type
      delete headers[&#39;Content-Type&#39;]
      return data
    }],
    data: formData,
    timeout: 300000
  }).then(res => {
    ElMessage.success(&#39;资产添加成功&#39;);
  }).catch((err) => {
    console.log(err);
  });
###問題3######如果還要傳其他的參數,其他的參數必須也要append進去,否則可能會報參數錯誤。 ###
const formData = new FormData();
formData.append(&#39;file&#39;, file);
// 其他参数
formData.append(&#39;mailSys&#39;, mailSys);

以上是vue3如何使用el-upload上傳文件的詳細內容。更多資訊請關注PHP中文網其他相關文章!

陳述:
本文轉載於:yisu.com。如有侵權,請聯絡admin@php.cn刪除