antd 和 element上传文件详解与FormData详解

哈喽elements 2019-06-28

背景

平时工作中经常会遇到需要上传文件的情况,如果你用ant design 或者element ,它们都提供了上传的组件。 我们分别来看一下element 和 antd 手动上传怎么处理:

ant design 手动上传文件

antd官网有手动上传的demo:
在这里简单写一写实现,主要有 在jsx中引入Upload组件,将 fileList 作为props传入,fileList为选择的文件列表,和 上传函数的实现。

// jsx
 <div>
    <Upload fileList={this.state.fileList}>     // Upload 为上传组件
      <Button>
        <Icon type="upload" /> Select File
      </Button>
    </Upload>
    <Button onClick={this.handleUpload}>
        上传文件
    </Button>
</div>
//  handleUpload 的实现 使用 fetch 请求
const handleUpload = () {
    const formData = new FormData();
    fileList.forEach((file) => {   // fileList 是要上传的文件数组
      formData.append('files[]', file);
    });
    
    fetch(url: 'http:just.a.url.demo', {
      method: 'POST',
      headers: {
            credentials: 'same-origin'
          // 'Content-Type': 'multipart/form-data'  // 不要加上这个文件类型说明
      },
      body: formData
            
    })
    .then(response => response.json())
    .catch(error => console.error('Error:', error))
    .then(response => console.log('Success:', response));
}

Element 手动上传文件

element 和antd 不同,通过上传组件拿回的数据,element又封装了一层,所以传数据稍有不同。
以下是简单实现:

// template
<el-upload 
    :file-list="fileList"
    :auto-upload="false">
    <el-button slot="trigger" type="primary">选择文件</el-button>
    <el-button @click="submitUpload">上传文件</el-button>
</el-upload>
//  上传实现

const handleUpload = () {
    const formData = new FormData();
    fileList.forEach((file) => {        
        formData.append('files[]', file.raw);  // 这里与antd 不同的是,文件真正数据为 file.raw 
    });
    
    fetch(url: 'http:just.a.url.demo', {
      method: 'POST',
      headers: {
            credentials: 'same-origin'
          // 'Content-Type': 'multipart/form-data'  // 不要加上这个文件类型说明
      },
      body: formData
            
    })
    .then(response => response.json())
    .catch(error => console.error('Error:', error))
    .then(response => console.log('Success:', response));
}

想问几个问题:

虽然可以找得demo把文件传输了出去,但是心里有几个问题,如下:

1. 问什么传文件需要用FormData格式呢?传文件和传一般数据有什么不一样?

从传文件的历史来回答传文件问什么需要FormData 格式。

  • file 形式

在最开始的时候,文件上传的传统形式是使用 表单元素file。参照下面的代码:

  <form id="upload-form" action="upload.php" method="post" enctype="multipart/form-data" >

    <input type="file" id="upload" name="upload" /> <br />

    <input type="submit" value="Upload" />

  </form>

它在chrome浏览器中是这个样子:
antd 和 element上传文件详解与FormData详解

选择文件之后,点击Upload 按钮,文件开始上传。

  • iframe形式

使用form元素比较简单,但缺点也比较明显:上传同步、上传完成页面会刷新;
在HTML5出现之前,想要实现文件异步上传,只能通过iframe+form实现;
其原理是:文件上传时在页面中动态创建一个iframe元素和一个form元素,并将form元素的target属性指向动态创建iframe元素。当用户完成选择文件动作时,提交子页面中的 form。这时,iframe跳转,而父页面没有刷新。这使得上传结束后,服务器处理结果返回到动态iframe窗口而没有刷新页面;
具体code,这里不再枚举,感兴趣童鞋可以去 iframe+form 查看。

  • ajax + FormData 形式

哎呀,终于来到了现代社会,并且见到了咱们的主角 FormData。 ajax 大家肯定都知道了,异步刷新,无需重新加载整个网页的情况下,便能够更新部分网页。
那FormData 是什么呢? FormData是XMLHttpRequest Level 2添加的一个新接口,他可以 构建类似表单的键值对, 也就是说我们可以利用 FormData 来模拟表单控件,然后使用XMLHttpRequest的send()
方法来异步的提交这个"表单"。
看一下简单的使用 FormData传文件的例子

<body>
    <input type="file" id="upload" name="upload" />    
    <input type="button" value="提交"  onclick="demoUpload()" />
    <script type="text/javascript">
        function demoUpload() {
            console.log('submit');
            var myFile = document.getElementById('upload').files[0];
            var xhr = new XMLHttpRequest();
            var formData = new FormData();
            var url = 'http://hqy.qunar.com:8080/';
            // for (var key in params) {    
            //     formData.append(key, params[key]);
            // }
            formData.append('uploadFile', myFile); // 文件
            formData.append('name', 'qunar');  // 其它数据
            xhr.open('POST', url, true);  //这里的url为本地起的一个服务地址
            xhr.send(formData);
        }
    </script>
</body>

选择文件并上传后,通过浏览器看看网络情况。
antd 和 element上传文件详解与FormData详解

答案

啰啰嗦嗦这么多,终于知道了为什么传文件要用FormData了!!开心,简单来说就是,传文件一开始设计使用 form 来传,但是呢,使用form默认的上传方式存在诸多问题,比如同步啦,我想在上传之前处理一下数据啦,这个时候FormData 就站出来了,大喊 我可以构建类似表单的键值对,来模拟表单,发送的数据用我构建的对象就可以上传文件了。从此我们上传文件就欢欣鼓舞的来找FormData了。
好了,另一个小问题,文件和其他数据的不同,文件传输时是二进制数据,所以格式和一般数据不一样。 我们的FormData大侠不仅可以传文件也可以传一般数据哦,当然传输数据有很多种方式,比如get请求的时候跟在url后面。

2. 请求为什么要用fetch呢? 和过气网红Ajax 什么关系?和xhr 有什么关系呢?

认真看过问题1的回答,这个问题就很简单了。fetch api 是一个提供请求资源(包括通过网络)的接口,它和xhr(XMLHttpRequest)类似。
所以请求不是为什么要用fetch,而是fetch 只是一种方法,可以用fetch也可以用xhr(参考问题一中的 ajax + FormData demo),他们逻辑上是‘并列’的。
至于问和AJAX 什么关系,不如说 Ajax 和 xhr什么关系。因为Ajax的核心是XMLHttpRequest对象, Ajax异步的实现是通过new 一个 XMLHttpRequest对象,一般简称该对象对xhr。所以这里 fetch 是Ajax或XMLHttpRequest的一个替代方案。

3. 为什么传文件的时候,'content-type'不能指定 'multipart/form-data' 呢?

当指定为'multipart/form-data'的时候,还需要指定 boundary=something。如果不指定则会自动分配。

ps: 这些回答基于自己理解,如有不妥,希望路过的大神轻喷,指正。

FormData

MDN上这样解释FormData:
The FormData interface provides a way to easily construct a set of key/value pairs representing form fields and their values, which can then be easily sent using the XMLHttpRequest.send() method.It uses the same format a form would use if the encoding type were set to "multipart/form-data".
FormData 接口提供了一种方法,可以方便地构造一组表示表单字段和它们的值的键值对,然后可以使用XMLHtRPROQuest.send()方法轻松发送。如果一个表单设置编码格式为 multipart/form-data, 这个表单将和FormData 使用相同的格式。

从头说起 FormData

XHR

fetch

MDN 这样介绍Fetch,Fetch API 是和XHR类似的用于获取资源(包括通过网络)的一种接口方法,但是 Fetch API提供了更强大更灵活的API。fetch()便是其中一个全局方法。

3.1 XHR(XMLHttpRequest) 和 fetch 什么关系?

Fetch和XHR平行关系,

3.2 fetch 和 FormData

先来看fetch()几种常见的用法:

Uploading JSON data: POST JSON-encoded data.

var url = 'https://example.com/profile';
var data = {username: 'example'};

fetch(url, {
  method: 'POST', // or 'PUT'
  body: JSON.stringify(data), // data can be `string` or {object}!
  headers:{
    'Content-Type': 'application/json'
  }
}).then(res => res.json())
.catch(error => console.error('Error:', error))
.then(response => console.log('Success:', response));

upload a file

var formData = new FormData();
var fileField = document.querySelector("input[type='file']");

formData.append('username', 'abc123');
formData.append('avatar', fileField.files[0]);

fetch('https://example.com/profile/avatar', {
  method: 'POST',
  body: formData
})
.then(response => response.json())
.catch(error => console.error('Error:', error))
.then(response => console.log('Success:', response));

相关推荐