HTML5应用之文件上传

关注

转载最新推荐文章于 2026-10-01 10:00:59 发布 8.4w 阅读 AI 写同款· GEO 优化 ›

掌握HTML文件上传：从基础到高级技巧 HTML中的<input type="file">标签是实现文件上传功能的核心组件。通过设置type="file"，用户可以选择本地文件进行上传。常用属性包括accept（限制文件类型）、multiple（允许多文件上传）、capture（优先使用摄像头或麦克风）和required（必须选择文件）。表单需配置enctype="multipart/form-data"和method="POST"以确保文件正确上传。Ja 阅读详情

HTML5解决了以往网页编写的一个难题：带有上传进度的文件上传。

本文的代码全部来自http://www.matlus.com/html5-file-upload-with-progress/，如在技术细节上有任何疑问，请以原文为主。

长期以来，开发者们一直为此苦恼，大部分为解决这个问题都采用了flash作为解决方案，但flash并非灵丹妙药，因为flash版本，割据造成的问题有时反倒成为了噩梦。有些网站则采用了form标签的enctype=multipart/form-data属性，但这一属性要求服务器作出特殊的设置才能够显示进度，而且本身也比较复杂，复杂就意味着容易出现错误，这可不是我们想要的。

现在我们来看看HTML5为什么能够解决这个问题，以及，它到底能做的多好。

用HTML5上传文件

在HTML5标准中，XMLHttpRequest对象被重新定义，被称为“XMLHttpRequest Level 2”，其中包含了以下5个新特性：

支持上传、下载字节流，比如文件、blob以及表单数据
增加了上传、下载中的进度事件
跨域请求的支持
允许发送匿名请求（即不发送HTTP的Referer部分）
允许设置请求的超时

在这篇教程中，我们主要关注第一和第二项特性，尤其是第二项——它能够提供我们想要的上传进度。和之前的方案不同，这个方案并不要求服务器作出特殊的设置，因此大家边看教程就可以边动手试试了。

上面图示的就是我们能够实现的内容：

显示上传的文件信息，比如文件名、类型、尺寸
一个能够显示真实进度的进度条
上传的速度
剩余时间的估算
已上传的数据量
上传结束后服务器返回的响应

另外，凭借XMLHttpRequest，我们的上传过程整个都是异步的，因此用户在上传文件的时候，依然可以操作网页当中的其它元素，并不需要专门等待上传的完成。而在上传结束后，我们能够获取服务器发回的响应，因此整个上传过程都显得相当顺理成章。

HTML5的进度事件

HTML5当中新增了一个进度事件（Progress Events），这个事件为我们提供了以下信息：

total – 文件大小
loaded – 已上传的大小
lengthComputable – 进度是否可计算

信息并不多，但是在计算文件进度上已经足够了。当然，也还有很多东西它没有直接给出，这非常遗憾。

HTML

与普通的文件上传代码并没有太大差异。不过注意，input标签关联了一个JavaScript函数在onchange上。

<!DOCTYPE html>
<html>
<head>
    <title>使用XMLHttpRequest上传文件</title>
</head>
<body>
<form id="form1" enctype="multipart/form-data" method="post" action="upload.php">
<div class="row">
      <label for="fileToUpload">Select a File to Upload</label>
<input type="file" name="fileToUpload" id="fileToUpload" onchange="fileSelected();"/>
    </div>
<div id="fileName"></div>
<div id="fileSize"></div>
<div id="fileType"></div>
<div class="row">
<input type="button" onclick="uploadFile()" value="Upload" />
    </div>
<div id="progressNumber"></div>
</form>

</body>
</html>

JavaScript

一旦我们在HTML中使用了input，我们就可以在JS代码中获取到一个FileList对象。这个对象是HTML5中新增加的文件API中的一部分，每一个FileList对象都是一组文件对象的集合，而文件对象则拥有下列的属性：

name – 文件名（不包含路径）
type – 文件的MIME类型（小写）
size – 文件的尺寸（单位为字节）

这正是我们所需要的。当然，HTML5中还有一个FileReader对象，但在这里我们并没有用它。现在，通过上面的三个内容，我们已经能够控制用户上传的文件大小和文件类型，以便减轻服务器再次检测时的压力，并提升安全系数。

function fileSelected() {
  var file = document.getElementById('fileToUpload').files[0];
  if (file) {
    var fileSize = 0;
    if (file.size > 1024 * 1024)
      fileSize = (Math.round(file.size * 100 / (1024 * 1024)) / 100).toString() + 'MB';
    else
      fileSize = (Math.round(file.size * 100 / 1024) / 100).toString() + 'KB';

    document.getElementById('fileName').innerHTML = 'Name: ' + file.name;
    document.getElementById('fileSize').innerHTML = 'Size: ' + fileSize;
    document.getElementById('fileType').innerHTML = 'Type: ' + file.type;
  }
}

那么当用户选择好文件，点击上传之后，又将发生什么呢？

function uploadFile() {
  var xhr = new XMLHttpRequest();
  var fd = document.getElementById('form1').getFormData();

  /* event listners */
  xhr.upload.addEventListener("progress", uploadProgress, false);
  xhr.addEventListener("load", uploadComplete, false);
  xhr.addEventListener("error", uploadFailed, false);
  xhr.addEventListener("abort", uploadCanceled, false);
  /* Be sure to change the url below to the url of your upload server side script */
  xhr.open("POST", "upload.php");
  xhr.send(fd);
}

function uploadProgress(evt) {
  if (evt.lengthComputable) {
    var percentComplete = Math.round(evt.loaded * 100 / evt.total);
    document.getElementById('progressNumber').innerHTML = percentComplete.toString() + '%';
  }
  else {
    document.getElementById('progressNumber').innerHTML = 'unable to compute';
  }
}

function uploadComplete(evt) {
  /* This event is raised when the server send back a response */
  alert(evt.target.responseText);
}

function uploadFailed(evt) {
  alert("There was an error attempting to upload the file.");
}

function uploadCanceled(evt) {
  alert("The upload has been canceled by the user or the browser dropped the connection.");
}

在代码的第二行中，我们的JS代码又使用了另一个HTML5推出的新对象——FormData。FormData对象是用户的表单数据的集合，它以键值对的形式存储了表单数据，其值能够包括数字、字符串以及文件。我们通过辗转这个对象，来向服务器提交数据。

当然，这个对象我们也可以在代码中手工构建，比如说像下面这样：

var fd = new FormData();
fd.append("author", "Shiv Kumar");
fd.append("name", "Html 5 File API/FormData");
fd.append("fileToUpload", document.getElementById('fileToUpload').files[0]);

回到正题。回顾上一段代码，我们增加了许多有关XMLHttpRequest的事件监听，其目的是为了获取文件上传的真实情况。尤其需要注意的是，我们所挂钩的，并不是XMLHttpRequest本身，而是其属性，比如uploadProgress。

完整代码

最后，来看看完整的代码。

<!DOCTYPE html>
<html>
<head>
    <title>Upload Files using XMLHttpRequest - Minimal</title>

    <script type="text/javascript">
      function fileSelected() {
        var file = document.getElementById('fileToUpload').files[0];
        if (file) {
          var fileSize = 0;
          if (file.size > 1024 * 1024)
            fileSize = (Math.round(file.size * 100 / (1024 * 1024)) / 100).toString() + 'MB';
          else
            fileSize = (Math.round(file.size * 100 / 1024) / 100).toString() + 'KB';

          document.getElementById('fileName').innerHTML = 'Name: ' + file.name;
          document.getElementById('fileSize').innerHTML = 'Size: ' + fileSize;
          document.getElementById('fileType').innerHTML = 'Type: ' + file.type;
        }
      }

      function uploadFile() {
        var fd = new FormData();
        fd.append("fileToUpload", document.getElementById('fileToUpload').files[0]);
        var xhr = new XMLHttpRequest();
        xhr.upload.addEventListener("progress", uploadProgress, false);
        xhr.addEventListener("load", uploadComplete, false);
        xhr.addEventListener("error", uploadFailed, false);
        xhr.addEventListener("abort", uploadCanceled, false);
        xhr.open("POST", "UploadMinimal.aspx");
        xhr.send(fd);
      }

      function uploadProgress(evt) {
        if (evt.lengthComputable) {
          var percentComplete = Math.round(evt.loaded * 100 / evt.total);
          document.getElementById('progressNumber').innerHTML = percentComplete.toString() + '%';
        }
        else {
          document.getElementById('progressNumber').innerHTML = 'unable to compute';
        }
      }

      function uploadComplete(evt) {
        /* This event is raised when the server send back a response */
        alert(evt.target.responseText);
      }

      function uploadFailed(evt) {
        alert("There was an error attempting to upload the file.");
      }

      function uploadCanceled(evt) {
        alert("The upload has been canceled by the user or the browser dropped the connection.");
      }
    </script>
</head>
<body>
<form id="form1" enctype="multipart/form-data" method="post" action="upload.php">
<div class="row">
      <label for="fileToUpload">Select a File to Upload</label>
<input type="file" name="fileToUpload" id="fileToUpload" onchange="fileSelected();"/>
    </div>
<div id="fileName"></div>
<div id="fileSize"></div>
<div id="fileType"></div>
<div class="row">
<input type="button" onclick="uploadFile()" value="Upload" />
    </div>
<div id="progressNumber"></div>
</form>

</body>
</html>