DIV CSS 佈局教程網

Ajax + FormData 實作無刷新表單提交與檔案上傳進度條
編輯:關於JavaScript     

傳統表單提交一定會帶走頁面,使用體驗總是打斷的。而 HTML5 帶來的 FormData 物件,讓這件事變得意外簡單:一行程式就能把整個表單(包含檔案欄位)打包好,直接交給 XMLHttpRequest 送出。

核心原理

流程只有三步:

  1. 用 DOM 取得表單節點。
  2. new FormData(fm) 實例化,它就會自動收集 fm 底下所有表單域,包含一般欄位與上傳檔案。
  3. 交給 Ajax 送出,並攔住表單的預設行為。
var fd = new FormData(fm); // 實例化,fd 內部已含所有表單域資訊

一、前端頁面:表單與進度條

這裡額外示範了 xhr.upload.onprogress 的用法,可以即時得知檔案上傳的百分比,並用它驅動一個簡單的進度條。

<!DOCTYPE html>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<script type="text/javascript">
window.onload = function(){
  var fm = document.getElementsByTagName('form')[0];
  fm.onsubmit = function(){
    //利用 FormData 收集表單資訊
    var fd = new FormData(fm);
    //fd 內部會把普通表單域與上傳檔案域一併收集
    var xhr = new XMLHttpRequest();
    xhr.onreadystatechange = function(){
      if(xhr.readyState == 4){
        alert(xhr.responseText);
      }
    }
    //監聽上傳進度
    xhr.upload.onprogress = function(evt){
      var loaded = evt.loaded;
      var total = evt.total;
      var per = Math.floor((loaded/total)*100) + "%";
      document.getElementById('son').innerHTML = per;
      document.getElementById('son').style.width = per;
    }
    xhr.open('post','./05.php');
    xhr.send(fd);
    return false;//阻止瀏覽器預設提交
  }
}
</script>
<style type="text/css">
#pat {width:430px;height:40px; border:5px solid blue;}
#son {width:0;height:100%; background-color:lightblue;}
</style>
</head>
<body>
<h2>ajax + FormData 實現無刷新檔案上傳</h2>
<form method="post" action="">
  <p>用戶名:<input type="text" name="username" /></p>
  <p>密碼:<input type="password" name="password" /></p>
  <p>郵箱:<input type="text" name="email" /></p>
  <div id="pat"><div id="son"></div></div>
  <p>頭像:<input type="file" name="user_pic" /></p>
  <p><input type="submit" value="注冊" /></p>
</form>
</body>
</html>

要注意 return false 這一行不能省。少了它,瀏覽器還是會照原樣送出表單並跳頁,前面寫的 Ajax 就白做了。

二、後端 PHP:接收並保存檔案

整體流程是:本地檔案 →(上傳)→ PHP 處理 → 伺服器。這裡有個容易被忽略的編碼問題:本地檔名的編碼是 gb2312,而 PHP 程式的編碼是 UTF-8,伺服器端存的又是 gb2312。所以必須在程式裡把 UTF-8 的檔名轉碼成 GB2312,否則中文檔名會變成亂碼。

<?php
//$_FILES['user_pic']['error']
//0 -> ok
//1 -> 大小超過 php.ini 限制
//2 -> 大小超過 MAX_FILE_SIZE 限制
//3 -> 附件只上傳了一部分(不完整)
//4 -> 沒有上傳附件
if($_FILES['user_pic']['error'] > 0){
    exit('上傳附件有問題,有可能沒有附件');
}

$name = $_FILES['user_pic']['name'];
$name = iconv('UTF-8','GB2312',$name); //檔名編碼由 UTF-8 轉為 GB2312
$path = "./upload/";

//附件上傳邏輯
//move_uploaded_file(臨時路徑名, 真實路徑名);
if(move_uploaded_file($_FILES['user_pic']['tmp_name'], $path.$name))
    echo "success";
else
    echo "fail";

$_FILES[...]['error'] 的狀態碼很值得背起來:0 代表成功,1 是超出 php.ini 上限,2 是超出表單設定的 MAX_FILE_SIZE,3 表示只傳了一部分,4 則是使用者根本沒選檔案。先做這層檢查,後續邏輯才不會在髒資料上運行。

三、jQuery 版本:把表單序列化後送出

如果你已經在用 jQuery,也有更短的路。做法是先用 serializeArray() 把表單轉為鍵值對,再交給 $.ajax:

//將 form 轉為 AJAX 提交
function ajaxSubmit(url, frm, fn){
  var dataPara = getFormJson(frm);
  $.ajax({
    url: url,
    type: "post",
    data: dataPara,
    async: false,
    dataType: 'txt',
    success: fn
  });
}

//將 form 中的值轉為鍵值對
function getFormJson(frm){
  var o = {};
  var a = $(frm).serializeArray();
  $.each(a, function(){
    if(o[this.name] !== undefined){
      if(!o[this.name].push){
        o[this.name] = [o[this.name]];
      }
      o[this.name].push(this.value || '');
    }else{
      o[this.name] = this.value || '';
    }
  });
  return o;
}

//前台呼叫方式
// function autoSubmitFun(){
//   ajaxSubmit("autoSumitScoreAJAX.action", $('#formId'), function(){});
// }

這裡那段 if(!o[this.name].push) 的判斷是在處理同名欄位:第一次遇到時先存成字串,第二次遇到時把它推入陣列,之後再持續 append。少了這段,多選或同名的 checkbox 就會互相覆蓋。

兩種方案的取捨

FormData 的原生方案更適合有檔案上傳需求的場景,因為它天生就支援 multipart,還能搭配 upload.onprogress 做進度回饋。jQuery 的 serializeArray 方案寫起來快,但不含檔案欄位,只適合純文字表單。選哪一個,取決於你的表單裡有沒有 <input type="file">。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved