vue3.0搭配.net core實現(xiàn)文件上傳組件

更新時間：2020年10月29日 15:19:30 作者：青城同學

這篇文章主要介紹了vue3.0搭配.net core實現(xiàn)文件上傳組件，幫助大家開發(fā)Web應用程序，完成需求，感興趣的朋友可以了解下

在開發(fā)Web應用程序中，文件上傳是經常用到的一個功能。
在Jquery時代，做上傳功能，一般找jQuery插件就夠了，很少有人去探究上傳文件插件到底是怎么做的。
簡單列一下我們要做的技術點和功能點

使用技術

客戶端使用vue.js 3.0，并使用vue3新增的功能:Composition API ,服務器使用asp.net core

功能點

標簽美化
文件預覽
文件上傳
服務器接收文件

文件選擇美化

在標準的html文件選擇標簽，是十分不美觀的。大概就是下圖的樣子

但是我們的設計師的設計圖可不是這樣的啊，所以第一步是選擇美化一下樣式。

標簽美化

找遍整個搜索引擎，美化文件選擇標簽只有兩種方法

設置input標簽透明度為0，然后定位一個其他的容易修改樣式的標簽到透明度度為0的input標簽上。
設置input標簽的display為none，然后使用JavaScript來觸發(fā)當前input的點擊事件。

因為筆者最近在做基于vue.js 3.0的項目，需要自己自定義很多UI組件，所以參考了layui element ，它們都是使用第二種方式來美化文件選擇標簽。

假設我們UI設計圖是上圖的樣式，如果需要美化，只需要隱藏文件選擇的Input標簽。然后放置一個按鈕，然后設置按鈕的樣式為設計圖上的樣式即可

 <div class="uploader">
  <button>選擇文件</button>
  <input type="file" placeholder="請選擇文件" />
 </div>

.uploader {
 display: inline-block;
 button {
  background: #4e6ef2;
  color: aliceblue;
  padding: 5px;
  outline: none;
  border: none;
  &:hover {
   opacity: 0.8;
  }
  &:active {
   opacity: 1;
  }
 }
 input {
  display: none;
 }
}

美化完成組件后，我們需要用在button點擊的時候，使用JavaScript去點擊隱藏的input標簽

<template>
 <div class="uploader">
  <button @click="btnClick">選擇文件</button>
  <input type="file" placeholder="請選擇文件" ref="fileSelector" />
 </div>
</template>
 
<script>
import { ref } from "vue";
export default {
 name: "uploader",
 setup() {
  const fileSelector = ref(null);
  const btnClick = () => {
   fileSelector.value.click();
  };
  return {
   fileSelector,
   btnClick,
  };
 },
};
</script>

在Composition api中要獲取到標簽的ref，不能使用this.$refs來獲取。當然，你如果喜歡使用vue2的options api。那依然可以使用this.$refs來獲取標簽的el
只需要簡單的觸發(fā)input的click事件，就可以使瀏覽器彈出文件選擇框了。

文件預覽

基本上所有的文件上傳組件，都有預覽上傳圖片的功能。本文所寫的上傳組件當然也不例外。
監(jiān)聽input標簽的change事件，獲取到files對象。然后使用FileReader讀取文件信息。

const fileChange = (e) => {
   let files = e.target.files;
   console.log(files);
   for (let i = 0; i < files.length; i++) {
    let file = files[i];
    var fileReader = new FileReader();
    fileReader.addEventListener(
     "load",
     (event) => {
      console.log(event);
      data.imgList.push({
       base64: event.target.result,
      });
     },
     false
    );
    fileReader.readAsDataURL(file);
   }
  };

在Chromium內核等高版本瀏覽器中，無法像低版本瀏覽器一樣，能獲得文件的具體磁盤路徑。如果像以前用文件路徑去獲取文件。只能獲得一個 C:\fakepath"+文件名的路徑。無法獲取到真實文件路徑。據說可以通過某些方法獲取真實路徑。我試過，沒成功。有興趣的朋友可以試試。

文件上傳

選擇文件后，我們需要把文件保存到到服務器。在傳統(tǒng)的多頁面web程序中，只需要設置按鈕的type為submit，然后使用form表單直接提交文件和表單信息到服務器去。
但是我們做單頁面程序，一般來說是通過JavaScript的ajax去上傳文件。

 const uploadServer = (file) => {
   var form = new FormData();
   form.append("file", file);
   var xhr = new XMLHttpRequest();
   xhr.open("post", props.server);
   xhr.onreadystatechange = () => {
    if (xhr.readyState == 4 && xhr.status == 200) {
     var res = JSON.parse(xhr.responseText);
     console.log("上傳成功");
     data.logs.push({
      log: res,
     });
    }
   };
   xhr.upload.onprogress = (event) => {
    if (event.lengthComputable) {
     var percent = (event.loaded / event.total) * 100;
     console.log("上傳進度:" + percent);
    }
   };
   xhr.onerror = () => {
    console.log("上傳文件錯誤");
   };
   xhr.ontimeout = () => {
    console.log("上傳超時");
   };
   xhr.send(form);
  };

在頁面上新增一個按鈕，用來手動觸發(fā)上傳

 <div class="uploader">
  <button @click="btnClick">選擇文件</button>
  <button @click="uploadClick">立即上傳</button>
  <input
   type="file"
   placeholder="請選擇文件"
   ref="fileSelector"
   @change="fileChange"
   multiple
  />
  <div class="image-list">
   <img v-for="(item, i) in data.imgList" :key="i" :src="item.base64" />
  </div>
  <div class="log">
   <p v-for="(item, i) in data.logs" :key="i">{{ item.log }}</p>
  </div>
 </div>

點擊立即上傳按鈕，觸發(fā)上傳

	const uploadClick = () => {
   data.files.forEach((file) => {
    uploadServer(file);
   });
  };

服務器接收

在服務器編程中，我們使用C#來接收上傳的文件。

 /// <summary>
    /// 上傳
    /// </summary>
    /// <param name="files"></param>
    /// <returns></returns>
    [HttpPost("/upload")]
    public async Task<IActionResult> Upload([FromServices] IWebHostEnvironment host)
    {
      var files = Request.Form.Files;
      long size = files.Sum(f => f.Length);
      List<string> list = new List<string>();
      foreach (var formFile in files)
      {
        if (formFile.Length > 0)
        {
          var path = Path.Combine(host.WebRootPath, "files");
          
          if (!Directory.Exists(path))
          {
            Directory.CreateDirectory(path);
          }
          string fileName = $"{Guid.NewGuid():N}{Path.GetExtension(formFile.FileName)}";
          path = Path.Combine(path, fileName);
          var filePath = path;
 
          using var stream = System.IO.File.Create(filePath);
          await formFile.CopyToAsync(stream);
          var c = Path.VolumeSeparatorChar;
          list.Add($"{Request.Scheme}://{Request.Host.Value}/{Path.Combine("files", fileName).Replace(Path.DirectorySeparatorChar, Path.AltDirectorySeparatorChar)}");
        }
      }
 
      return Ok(new { list = list, size });
    }

使用dotnet run運行asp.net core服務端。然后點擊上傳，你以為就上傳成功了嗎？
不！沒那么簡單。如果如果vue程序和asp.net core程序，不在同一個域名下，你還得處理上傳跨域問題。當然這個問題在asp.net core中是非常簡單的。只需要簡單配置一下即可

如果在IIS或者Nginx下，就需要修改對應站點的配置文件了。當然具體服務器軟件的配置不在本篇文章的討論之下。有需要的同學可以私下交流
asp.net core跨域處理

 app.UseCors(options =>
      {
        options.WithOrigins("http://localhost:3000", "http://127.0.0.1", "http://localhost:8080"); // 允許特定ip跨域
        options.AllowAnyHeader();
        options.AllowAnyMethod();
        options.AllowCredentials();
      });

以上配置必須要放在app.UseStaticFiles();之前才會生效。

上傳成功后，你就會在服務器的wwwroot的files文件夾中看到上傳的圖片文件了。