兼容input 文件选择_「HTML5」FileAPI 文件操作实战

深藏阁楼爱情的钟 2022-11-19 11:20 108阅读 0赞

> 本文来自《FileAPI 文件操作实战》  
> 其他系列放在了Github， **欢迎交流和Star**

## 介绍 ##

HTML5 为我们提供了 File API 相关规范。主要涉及 File 接口 和 FileReader 对象 。

本文整理了兼容性检测、文件选择、属性读取、文件读取、进度监控、大文件分片上传以及拖拽上传等开发中常见的前端文件操作。

## 准备工作 ##

首先，我们的 File 来自于`<input>`标签中选中的文件列表。所以，准备如下的 HTML 代码：

## 检测兼容性 ##

File 对象是特殊类型的 Blob。在 script 入口处，应该检测当前浏览器是否支持 File API：

if (!(window.File && window.FileReader && window.FileList && window.Blob)) {
         
      throw new Error("当前浏览器对FileAPI的支持不完善");
    }

## 监听文件选择 ##

对于 type 为 file 类型的`<input>`标签，在选择文件的时候，会触发`change`事件。用户选中的文件信息也会传入回调函数的第一个参数中。

## 文件属性-File ##

`event.target.files` 是一个`FileList`对象，它是一个由`File`对象组成的列表。

每个 File 对象，保存着选中的对应文件的属性。常用的用：

*  name：文件名
 *  type：文件类型
 *  size：文件大小

下面，通过 type 属性，过滤掉非图片类型的文件，只展示图片类型文件的信息：

## 读取文件-FileReader ##

还是以图片读取为例，读取并且显示所有的图片类型文件。

文件读取需要使用`FileReader`对象，它常用 3 个回调方法：

*  onload: 文件读取完成
 *  onloadstart：文件上传开始
 *  onprogress : 文件上传中触发

**和`Image`类似，在读取文件之前，需要先绑定事件处理**。它读取操作有：readAsArrayBuffer、readAsDataURL、readAsBinaryString、readAsText。传入的参数就是`File`对象。

那么这几个方法有什么区别呢？**不同的读取方式，回调事件`onload`接受到的`event.target.result`不相同**。比如，`readAsDataURL`读取的话，result 是一个图片的 url。

下面就是读取图片文件，然后展示的一个例子：

## 监控读取进度 ##

在监控读取进度的时候，主要是处理 FileReader 对象上的 `onprogress` 事件。

下面的例子，请打开一个较大的文件来查看效果（否则一下就读取完了）：

## 大文件分片读取 ##

在对于超大文件，一般采用分片上传的思路解决。文章开头有讲到，File 是 Blob 的一个特例。而 Blob 上有一个slice 方法，通过它，前端就可以实现分片读取大文件的操作。

为了方便说明，请先准备好一个 txt 文件，文件内容就是：`hello world`。

示例代码如下，代码中只读取前 5 个字节，由于每个英文字母占 1 个字节，所以打印结果应该是“hello”。

## 拖拽上传 ##

和前面所述的 File API 相关是完全一样的。唯一需要特殊处理的是文件对象的获取入口改变了。对于`<input>`标签，监听 onchange 事件，FileList 存放在 event.target.files 中；对于拖拽操作，FileList 存放在拖拽事件的回调函数参数里，通过 event.dataTransfer.files 访问即可。

需要修改一下 html 代码：

<!DOCTYPE html>
    <head>
      <meta charset="UTF-8">
      <style>
        #container {
         
          width: 300px;
          height: 300px;
          border: 3px dotted red;
        }
      </style>
    </head>
    <body>
      <div id="container"></div>
      <script src="./script.js"></script>
    </body>
    </html>

脚本文件的代码如下：

function handleDropover(event) {
         
      event.stopPropagation();
      event.preventDefault();
    }
    
    function handleDrop(event) {
         
      event.stopPropagation();
      event.preventDefault();
      /***** 访问拖拽文件 *****/
      const files = event.dataTransfer.files;
      console.log(files);
      /**********/
    }
    
    const target = document.querySelector("#container");
    target.addEventListener("dragover", handleDropover);
    target.addEventListener("drop", handleDrop);

## 后端相关 ##

后端相关超出了本文的讨论范围，可以参考这篇文章。