「JS进阶」 HTML5 之文件操作(file)

言

在 HTML 文档中 <input type="file"> 标签每出现一次，一个 FileUpload 对象就会被创建。

该元素包含一个文本输入字段，用来输入文件名，还有一个按钮，用来打开文件选择对话框以便图形化选择文件。

该元素的 value 属性保存了用户指定的文件的名称，但是当包含一个 file-upload 元素的表单被提交的时候，浏览器会向服务器发送选中的文件的内容而不仅仅是发送文件名。

当用户选择或编辑一个文件名，file-upload 元素触发 onchange 事件句柄。

看个简单例子：

[html]view plaincopy

<!-- oscar999  -->

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">

<html>

  <head>

  <meta http-equiv="content-type" content="text/html; charset=utf-8">

  <meta name="author" content="oscar999">

  <title></title>

  <script>

  function  handleFiles(files)

    if(files.length)

       var file = files[0];

       var reader = new FileReader();

       reader.onload = function()

           document.getElementById("filecontent").innerHTML = this.result;

};

       reader.readAsText(file);

  </script>

  </head>

  <body>

  <input type="file" id="file" onchange="handleFiles(this.files)"/>

  <div id="filecontent"></div>

  </body>

</html>

这里读取一个文件，显示在div 中。

(在IE8 中无效， this.files 无法读取文件。这个属于HTML5 的特性)

当选择了一个文件时，就会把包含这个文件的列表（一个FileList对象）作为参数传给handleFiles()函数了。这个FileList对象类似一个数组，可以知道文件的数目，而它的元素就是File对象了。从这个File对象可以获取name、size、lastModifiedDate和type等属性。把这个File对象传给FileReader对象的读取方法，就能读取文件了。

HTML5 Drag and Drop File

Html5 支持的File 的操作不仅仅是文件的选择，

在HTML5 之前需要使用 Applet 和 SilverLight 才能达到的文件拖拽功能，在HTML5 中也能轻松的实现，

看代码：

[html]view plaincopy

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">

<html>

  <head>

  <meta http-equiv="content-type" content="text/html; charset=utf-8">

  <meta name="author" content="oscar999">

  <title></title>

  </head>

  <body>

    <div id="dropbox"> Drop Here </div>

    <div id="filecontent"></div>

    <script>

      var dropbox = document.getElementById("dropbox");

      dropbox.addEventListener("dragenter", dragenter, false);

      dropbox.addEventListener("dragover", dragover, false);

      dropbox.addEventListener("drop", drop, false);

    function dragenter(e) {

        e.stopPropagation();

        e.preventDefault();

    function dragover(e) {

        e.stopPropagation();

        e.preventDefault();

    function drop(e) {

        e.stopPropagation();

        e.preventDefault();

        var dt = e.dataTransfer;

        var files = dt.files;

        if(files.length)

           var file = files[0];

           var reader = new FileReader();

           reader.onload = function()

               document.getElementById("filecontent").innerHTML = this.result;

};

           reader.readAsText(file);

    </script>

  </body>

</html>

这里通过事件对象的 dataTransfer 可以得到文件。

读取文件内容

在第一个例子中，我们使用 FileReader类来读取文件的内容，

在 W3C 草案中，File 对象只包含文件名，文件类型等只读属性;FileReader用于内容读取和监控读取状态。

（在firefox 中，可以直接使用 var fileBinary = file.getAsBinary(); 读取文件的二进制源码）

FileReader提供的方法包括：

1. readAsBinaryString

2. readAsDataURL

3. readAsText

4. abort

.........

以下，举一个使用 FileReader 将用户选择的图片不通过后台即时显示出来的例子。

[html]view plaincopy

function handleFiles(files){

    for (var i = 0; i < files.length; i++) {

        var file = files[i];

        var imageType = /image.*/;

        if (!file.type.match(imageType)) {

            continue;

        var img = document.createElement("img");

        img.classList.add("obj");

        img.file = file;

        preview.appendChild(img);

        var reader = new FileReader();

        reader.onload = (function(aImg){

            return function(e){

                aImg.src = e.target.result;

};

        })(img);

        reader.readAsDataURL(file);

同后端的交互

在一般的HTML 中，使用方式是把file input 放在form 中，以POST 方式把文件传递到后端。

在 HTML5 中，也可以通过 FileReader 的 readAsBinaryString 方法读取到文件的二进制码，然后通过 XMLHttpRequest 的 sendAsBinary 方法将其发送出去。

[javascript]view plaincopy

var xhr = new XMLHttpRequest();

xhr.open("POST", "url");

xhr.overrideMimeType('text/plain; charset=x-user-defined-binary');

<pre code_snippet_id="422893" snippet_file_name="blog_20140709_4_2106578" class="sh_javascript sh_sourceCode" name="code">xhr<span class="sh_symbol">.</span><span class="sh_function">sendAsBinary</span><span class="sh_symbol">(</span>binaryString<span class="sh_symbol">);</span></pre><br>

者：HelloGitHub-kalifun

这是 HelloGitHub 推出的《讲解开源项目》^[1]系列，今天给大家推荐一个

JavaScript 开源的文件上传库项目——FilePond

一、介绍

1.1 FilePond

它是一个 JavaScript 文件上传库。可以拖入上传文件，并且会对图像进行优化以加快上传速度。让用户体验到出色、进度可见、如丝般顺畅的文件上传体验。

FilePond 项目地址：https://github.com/pqina/filepond

1.2 特点和优势

上传内容：支持目录、文件、多个文件、本地路径、远程 URL 等。
文件管理：删除文件、选择文件、复制和粘贴文件、或使用 API 方式添加文件。
上传方式：使用 AJAX 进行异步上传、或将文件编码为 base64 数据用表单发送。
图像优化：自动调整图像大小、裁剪和修复 EXIF 方向。
响应式：可在移动和桌面设备上使用。

看了效果图和功能介绍，是不是有些手痒了。接下来就是实战操作部分，大家可以跟着文章一步步的把这个库使用起来，点亮你的文件上传技能点！

实战操作

下面我们将一步步的讲解如何使用 FilePond 这个库。我们采用的是最简单的 CDN 引用方式，方便大家能够快速体检其魅力（复制代码便可查看效果），接着会深入讲解每个插件的功能，最终编写了一个组合了几个插件的示例及运行效果展示。

Tips： 解释说明均在代码中以注释方式展示，请大家注意阅读。

2.1快速使用（CDN）

示例代码：

<!DOCTYPE html>
<html>
<head>
 <!-- html 标题 -->
 <title>FilePond from CDN</title>

 <!-- 引入Filepond的css -->
 <link href="https://unpkg.com/filepond/dist/filepond.css" rel="stylesheet">

</head>
<body>

<!-- input标签作为文件上传入口 -->
<input type="file" class="filepond">

<!-- 引入FilePond的js -->
<script src="https://unpkg.com/filepond/dist/filepond.js"></script>


<script>
 // FilePond.parse 使用类.filepond解析DOM树的给定部分，并将它们转换为FilePond元素。
 FilePond.parse(document.body);
</script>

</body>
</html>

展示效果：

2.2

引入插件

似乎单纯的上传功能是否无法满足我们的需求，FilePond 该库拥有多样、强大的插件部分，可以根据自己的需求选择插件组合起来使用哦。下面先简单的了解一下每个插件的功能：

File Rename：重命名客户端上的文件
File Encode：将文件编码为 base64 数据
File size Validation：文件大小验证工具
File Type Validation：文件类型验证工具
File Metadata：限制要添加的文件类型
File Poster：在文件项目中显示图像
Image Preview：显示图像文件的预览
Image Edit：手动编辑图像文件
Image Crop：设置图像文件的裁剪比例
Image Resize：设置图像文件的输出尺寸
Image Transform：上传之前在客户端上图像变换
Image EXIF Orientation：提取 EXIF^[2] 方向信息
Image Size Validation：限制要添加的图像的尺寸
Image Filter：将颜色矩阵应用于图像像素

下面我来介绍如何引入插件吧！

坑！： 使用插件前，一定要查阅清楚该插件是否有 CSS 文件，如果有请在<head><link href="xxx.css" rel="stylesheet"></head>标签中引入哦。

<head>
 <!-- 引入图像预览插件的css文件 -->
 <link href="https://unpkg.com/filepond-plugin-image-preview/dist/filepond-plugin-image-preview.css" rel="stylesheet">
</head>
<!-- 引入图像预览插件的js文件 -->
<script src="https://unpkg.com/filepond-plugin-image-preview/dist/filepond-plugin-image-preview.js"></script>

<script>

// 注册插件 FilePondPluginImagePreview 图像预览插件为已上传的图像呈现缩小的预览。
FilePond.registerPlugin(FilePondPluginImagePreview);
</script>

我们梳理一下引入插件的步骤：引入 CSS 文件（部分插件有 CSS 文件）
引入 JS 文件
注册插件
配置插件（部分插件需配置）

2.3 配合插件使用

完整示例代码：

<!DOCTYPE html>
<html>
<head>
 <title>FilePond from CDN</title>

 <!-- Filepond CSS -->
 <link href="https://unpkg.com/filepond/dist/filepond.css" rel="stylesheet">
 <!-- FilePondPluginImagePreview 插件 CSS-->
 <link href="https://unpkg.com/filepond-plugin-image-preview/dist/filepond-plugin-image-preview.css" rel="stylesheet">
 <!-- FilePondPluginImageEdit 插件 CSS-->
 <link href="https://unpkg.com/filepond-plugin-image-edit/dist/filepond-plugin-image-edit.css" rel="stylesheet">
</head>

<body>

<!-- 我们将把这个输入框变成上传文件框 -->
<input type="file" class="filepond">

<!-- FilePondPluginImagePreview 插件js-->
<script src="https://unpkg.com/filepond-plugin-image-preview/dist/filepond-plugin-image-preview.js"></script>
<!--FilePondPluginImageEdit 插件js-->
<script src="https://unpkg.com/filepond-plugin-image-edit/dist/filepond-plugin-image-edit.js"></script>
<!--FilePondPluginFileValidateSize 插件js-->
<script src="https://unpkg.com/filepond-plugin-file-validate-size/dist/filepond-plugin-file-validate-size.js"></script>
<!--FilePondPluginFileValidateType 插件js-->
<script src="https://unpkg.com/filepond-plugin-file-validate-type/dist/filepond-plugin-file-validate-type.js"></script>
<!--FilePondPluginImageCrop 插件js-->
<script src="https://unpkg.com/filepond-plugin-image-crop/dist/filepond-plugin-image-crop.js"></script>
<!--FilePondPluginImageExifOrientation 插件js-->
<script src="https://unpkg.com/filepond-plugin-image-exif-orientation/dist/filepond-plugin-image-exif-orientation.js"></script>
<!--引入Filepond的js-->
<script src="https://unpkg.com/filepond/dist/filepond.js"></script>

<script>
 // querySelector() 方法返回文档中匹配指定 CSS 选择器的一个元素。
 var inputElement = document.querySelector('input[type="file"]');

 // 注册插件
 // FilePondPluginImagePreview 上传时可以预览到上传的图片等
 // FilePondPluginImageEdit 由于doka收费，所以编辑功能就不演示了。
 // FilePondPluginFileValidateType 图片类型
 // FilePondPluginImageCrop 图像裁剪
 // FilePondPluginFileValidateSize 文件大小验证插件处理阻止太大的文件。
 FilePond.registerPlugin(
 FilePondPluginImagePreview,
 FilePondPluginImageEdit,
 FilePondPluginFileValidateSize,
 FilePondPluginImageCrop,
 FilePondPluginFileValidateType,
 FilePondPluginImageExifOrientation

 );

 FilePond.setOptions({
 // 设置单个URL是定义服务器配置的最基本形式。
 server: '/upload',
 // 设置图片类型只能为png才能上传
 allowFileTypeValidation: false,
 acceptedFileTypes: "image/jpg",
 // 启用或禁用图像裁剪
 allowImageCrop: true,

 // 启用或禁用文件大小验证
 allowFileSizeValidation: true,
 maxFileSize: null,

 // 启用或禁用提取EXIF信息
 allowImageExifOrientation: true

 });

 // 使用create方法逐步增强基本文件输入到FilePond元素。
 FilePond.create(inputElement)
</script>

</body>
</html>

上面的示例展示了 FilePond 常用插件的方法，效果展示如下：

当然还

其它方法如： destroys：销毁实例
find：返回附加提供的元素的实例
getOptions：返回当前的配置项
supported：鉴别浏览器是否支持 FilePond

这里就不做完整的讲解了，有兴趣的可以自行尝试使用这些方法。

三、总结

以上就是讲解的全部内容，FilePond 是一款很轻便的上传插件。并没有太多繁琐的配置，这里我并没有逐一针对每个插件引入进行演示，只展示了常用的部分。留意上面提示的坑，掌握上面讲解的方法，其它的插件你便可自行学习。

FilePond 是一款很值得参考和使用的 JavaScript 库，如果想让自己网站快速加入上传功能，不妨试试它吧。

References

[1] 《讲解开源项目》: https://github.com/HelloGitHub-Team/Article

[2]EXIF: https://baike.baidu.com/item/Exif/422825?fr=aladdin

[3]FilePond 官方文档: https://pqina.nl/filepond/docs/

[4]FilePond Plugins List: https://pqina.nl/filepond/plugins.html

关注公众加入交流群，一起讨论有趣的技术话题

『讲解开源项目系列』——让对开源项目感兴趣的人不再畏惧、让开源项目的发起者不再孤单。跟着我们的文章，你会发现编程的乐趣、使用和发现参与开源项目如此简单。欢迎联系我（微信：xueweihan 备注：讲解）加入我们，让更多人爱上开源、贡献开源～

我们浏览网页时可能需要把网页上的内容保存下来，这时候有几种方式可以做到：1、把重要的内容复制出来；2、对网页进行截图保存，我们推荐过的截图插件如印象笔记·剪藏、Full Page Screen Capture等；3、把网页保存成PDF，如Adobe Acrobat。4、直接把网页保存成HTML。当然所有浏览器都有另存页面为HTML 文档的功能，不过可能会遇到一些问题，保存后不是各种资源如JS、CSS和图片的文件很多，就是打开后无法载入样式表，图片显示不出来，要把网页备份起来或传送给别人就很麻烦。本文要介绍的SingleFile是一款免费浏览器扩展，可以将完整的页面保存到一个HTML文件中，包括所有CSS和图片等等，让用户即使在一个HTML文档中也能浏览完整内容。除了单一页面外，SingleFile还支持保存选中的部分、非固定标签页或所有页面，操作上也非常的简单易用。如果你有保存页面的需求，可以试试这款插件。

简介

SingleFile

在线咨询

上一篇：一键生成通用高亮代码块到剪贴板，可粘贴到在线编辑器
下一篇：HTML中的href属性：掌握超链接技巧，提升网站用户体验

您的项目需求

*请认真填写需求信息，我们会在24小时内与您取得联系。

整合营销服务商

「JS进阶」 HTML5 之文件操作(file)

言

HTML5 Drag and Drop File

读取文件内容

同后端的交互

您的项目需求