前端实现文件下载和拖拽上传

需求

1. 页面中增长下载示例按钮
2. 实现一块区域可以拖拽上传word文件，限制文件大小2MB和文件类型，能显示进度条，同时支持取消上传。

文件下载

业务中要求的是示例放在静态文件夹中，并不须要请求后台。针对这种场景，笔者将介绍三种方法，分别是 window.open，form表单提交以及a标签 下载。笔者将经过下载img和word文档的例子，对这三种方法进行对比。

现构建dom结构以下：

<button onClick={this.windowOpen}>window.open</button>
<button onClick={this.formSubmit}>formSubmit</button>
<button onClick={this.aDownload}>aDownload</button>

方法一：使用 window.open ：

import gakkiURL from './gakki.jpg';
import wordURL from './wordURL.doc';
windowOpen = () => {
    window.open(gakkiURL);
    //window.open(wordURL);
}

该方法在请求两种文件时，具体表现为:

img：新开网页，而后显示对应的img图片。

word：下载该文件。

方法2：使用form表单的submit：

formSubmit = () => {
    let form = document.createElement('form');
    form.method = 'get';
    form.action = gakkiURL;
    //form.action = wordURL;
    //form.target = '_blank';    // form新开页面
    document.body.appendChild(form); // form表单作出提交操做要先加入到dom树中
    form.submit();
    document.body.removeChild(form);
}

该方法在请求两种文件时，具体表现为:

img：form在不设置target时，会在当前页面打开url，显示图片。

word：下载该文件。

从上述两种方法能够看出，在请求对应的url时， 浏览器针对不一样的MIME类型会选择不一样的处理方式 。在请求img、txt等格式时，浏览器会打开对应的文件，而不是下载。若是想要img这些格式也下载呢？此时就须要方法三。

方法3：使用a标签：

// 使用a标签
aDownload = () => {
    const a = document.createElement('a');
    a.href = gakkiURL;
    //a.href = wordURL;
    //a.download = 'gakki.jpg';
    a.click();
}

a标签在不加download属性时表现同上两种方法，而在加了 download 属性后，可成功触发img等格式的下载。

download：

该属性能够设置一个值来规定下载文件的名称。所容许的值没有限制，浏览器将自动检测正确的文件扩展名并添加到文件 (.img, .pdf, .txt, .html, 等等)。

最终对比效果：

文件拖拽上传

文件上传

经常使用方法是使用 type="file" 的input标签触发下载，而后使用formData传输数据，代码以下：

// 点击上传文档
handleClick = () => {
    const input = document.createElement('input');
    input.type = 'file';
    input.accept = 'application/msword, application/vnd.openxmlformats-officedocument.wordprocessingml.document'; // word文件对应的MIME类型
    input.onchange = (e) => {
        const file = e.target.files.items(0);// files[0]也行
        console.table(file);
        // 检查文档格式
        if (!this.checkDocument()) {
            e.target.value = '';
            return;
        }
        // 上传文档
        this.uploadDocument(file);
    };
    input.click();
};

accept ：代表input接受的文件的MIME类型。.doc和.docx相应的MIME类型在源码中已标明。

fileList对象可经过items或数组索引的形式得到对应的file对象。file对象经常使用的属性有：lastModified、type、name和size。可经过这些属性自定义检查文档格式。

检查文档的代码checkDocument以下：

// 文档检查
checkDocument = file => {
    const accept = ['.doc', '.docx'];
    const index = file.name.lastIndexOf('.');
    if (index < 0 || accept.indexOf(file.name.substr(index).toLowerCase()) < 0) { // 检查文件类型
        Message.error('暂不支持该文件格式');
        return false;
    }
    if (file.size > 2 * 1024 * 1024) { // 检查文件大小
        Message.error('文档大于2MB，上传失败');
        return false;
    }
    return true;
};

以后是上传文档uploadDocument：

// 上传文档
uploadDocument = file => {
    const index = file.name.lastIndexOf('.');
    const fileName = file.name.slice(0, index);
    const formData = new FormData();
    formData.append('file', file);
    // ajax、fetch或axios等方式上传
    ...
};

上传文档后须要去获取上传进度显示进度条，下面将对 ajax、fetch和axios对progress事件的支持状况 分别予以介绍。

Ajax

原生支持progress事件，可用于获取上传进度和下载进度，分别为 xhr.upload.onprogress 和 xhr.onprogress 事件。代码以下：

xhr.upload.onprogress = ev => console.log((ev.loaded / ev.total) * 100)

另外可使用 xhr.abort() 取消文件上传。

Fetch

不支持progress事件，因此没法获取上传进度。可是笔者在查阅资料时发现因为res.body是可读字节流对象，因此可使用res.body对象支持的 getReader() 属性得到 下载进度 ，具体文献请参考 jakearchibald.com/2016/stream… 。此处代码与上传的需求无关，仅做为fetch的相关拓展，可直接跳过这一段。

res.body.getReader() 方法用于读取响应的原始字节流，该字节流是能够循环读取的，直至body内容传输完成；

fetch(url, options).then(res => {
    let reader = res.body.getReader();
    let loaded = 0;

    // read()方法返回一个promise，接受值时resolve。
    reader.read().then(function processResult(result) {
        // result对象有两个属性：
        // done：完成时为true
        // value 数据
        if (result.done) { // 完成时退出循环
            console.log("Fetch complete");
            return;
        }

        loaded += result.value.length;// 长度，单位：字节
        console.log('Received', loaded, 'bytes of data so far');

        // 循环读取
        return reader.read().then(processResult);
    });
});

Axios

经过 onUploadProgress 和 onDownloadProgress 实现上传和下载。

onUploadProgress(ev) => {
    length = Math.round((ev.loaded / ev.total) * 100);
    console.log(length);
}

axios使用 cancel token 取消请求

var CancelToken = axios.CancelToken;
var source = CancelToken.source();

axios.get(url, {
  cancelToken: source.token
})

source.cancel();//取消请求

总结

ajax和axios对progress事件都进行了很好地支持，而fetch因为缺乏对progress事件的支持在这里没法使用。

拖拽事件

实现了点击上传、得到上传进度以及取消上传等功能后，接下来要完成的是实现拖拽上传。实现前，我将对有关事件进行介绍。 首先是拖拽物体时发生的事件： onDragStart ， onDrag 和 onDragEnd ，事件与被拖拽的物体有关。

onDragStart ：拖拽开始

onDrag ：拖拽中持续触发

onDragEnd ：拖拽结束，不管是否能够放置均触发事件

而后是放置文件时要触发的事件： onDragEnter ， onDragOver ， onDragLeave 和 onDrop ，事件与要拖放进的区域有关。

onDragEnter ：拖拽的物体进入时触发

onDragOver ：拖拽的物体在区域中拖动时持续触发

onDragLeave ：拖拽的物体离开区域时触发

onDrop ：拖拽的物体放置在区域中时触发

项目中为了可以拖拽word文档，须要在容器上取消该容器默认的onDragEnter和onDragOver事件，这是由于：

事件的侦听器 dragenter 或 dragover 事件被用来表示有效的 drop 目标，也就是拖放项目可能被 dropped 的地方。web页面或应用程序的大多数区域都不是 drop 数据的有效位置。所以，这些事件的默认处理是不容许出现 drop。

若是您想要容许 drop，您必须经过取消事件来防止默认的处理。您能够经过从attribute-defined 事件监听器返回 false ，或者经过调用事件的 preventDefault 方法来实现这一点。后者在一个单独的脚本中定义的函数中可能更可行。

dom结构以下：

<div
    styleName="dropbox"
    onDragOver={this.preventDefault}
    onDragEnter={this.preventDefault}
    onDrop={this.handleDrop}
    >
    <div styleName="word-img" />
    {this.renderBtnByUpload(this.state.uploadStatus)} // 根据上传状态决定是"上传文件"仍是"取消上传"
</div>

在将文件拖拽到内容区放置后，能够经过 dataTransfer 对象得到file信息。最终的handleDrop事件以下：

// 拖拽上传
handleDrop = (e) => {
    const file = e.dataTransfer.files[0];
    if (e.dataTransfer.files.length > 1) {
        Message.error('仅支持上传一个word文件');
        return;
    }
    if (!this.checkDocument(file)) {
        // 上传失败直接退出
        e.target.value = '';
        return;
    }
    this.uploadDocument(file); // 上传文件
}

总结

最终，实现的整体思路就是，首先构建放置文件的容器，而后给该容器取消默认的 onDragOver和 onDragEnter 事件，当拖拽文件到容器中时经过 dataTransfer.files 拿到文件并上传，使用ajax或axios等方式提供的progress事件拿到长度，将该长度传到progressBar组件中，最后展现出来。

原文连接：https://www.jianshu.com/p/01c...