JavaScript 非同步提交表單的6種方式
零、在學習非同步提交表單之前,先來學習幾個JQuery方法和屬性
1、serialize():序列表格內容為字串。如下:
queryBean.orderBy=OPERATE_TIME&queryBean.orderSequnce=DESC&queryBean.title=&queryBean.province=&queryBean.city=&selectID=ad78f509f2bc412fb9fe16e36d227a11&queryBean.orderBy=OPERATE_TIME&queryBean.orderSequnce=DESC&queryBean.page.intPage=1
2、serializeArray():序列化表格元素 (類似 ‘.serialize()’ 方法) 返回 JSON 資料結構資料。
注意,此方法返回的是JSON物件而非JSON字串。需要使用外掛或者第三方庫進行字串化操作。
返回的JSON物件是由一個物件陣列組成的,其中每個物件包含一個或兩個名值對——name引數和value引數(如果value不為空的話)。舉例來說:
[
{
"name": "firstname",
"value": "Hello"
},
{
"name": "lastname",
"value ": "World"
},
{
"name": "alias"
}
]
3、data屬性:傳送到伺服器的資料。將自動轉換為請求字串格式。GET 請求中將附加在 URL 後。檢視 processData 選項說明以禁止此自動轉換。必須為 Key/Value 格式。如果為陣列,jQuery 將自動為不同值對應同一個名稱。如 {foo:[“bar1”, “bar2”]} 轉換為 “&foo=bar1&foo=bar2”。
4、dataType屬性:預期伺服器返回的資料型別。如果不指定,jQuery 將自動根據 HTTP 包 MIME 資訊來智慧判斷,比如XML MIME型別就被識別為XML。在1.4中,JSON就會生成一個JavaScript物件,而script則會執行這個指令碼。隨後伺服器端返回的資料會根據這個值解析後,傳遞給回撥函式。可用值:
“xml”: 返回 XML 文件,可用 jQuery 處理。
“script”: 返回純文字 JavaScript 程式碼。不會自動快取結果。除非設定了”cache”引數。”’注意:”’在遠端請求時(不在同一個域下),所有POST請求都將轉為GET請求。(因為將使用DOM的script標籤來載入)。
“json”: 返回 JSON 資料 。
“jsonp”: JSONP 格式。使用 JSONP 形式呼叫函式時,如 “myurl?callback=?” jQuery 將自動替換 ? 為正確的函式名,以執行回撥函式。
“text”: 返回純文字字串
一、ajax方式
<script type="text/javaScript">
$.ajax({
url:"mobileSurveyAction_addSurvey.action",//提交地址
data:$("#form1").serialize(),//將表單資料序列化
type:"POST",
dataType:"json",
success:function(result){
if (result.success == '100'){
$("#mySection").hide();
$(".footer").hide();
$("#alertMsg").show();
}else{
alert("失敗!");
}
}
});
</script>
二、submit方式
有時在A頁面點選按鈕彈出一個form表單,在填完表單後提交成功後,需要關閉表單頁並將表單中的某些值反應在A頁面上,這時就需要非同步提交表單。其實也挺簡單,只是需要把表單資料序列化。
<script type="text/javaScript">
$("#form1").submit(function (){
var ajax_url = "yourActionUrl"; //表單目標
var ajax_type = $(this).attr('method'); //提交方法
var ajax_data = $(this).serialize(); //表單資料
$.ajax({
type:ajax_type, //表單提交型別
url:ajax_url, //表單提交目標
data:ajax_data, //表單資料
success:function(msg){
if(msg == 'success'){//msg 是後臺呼叫action時,你傳過來的引數
//do things here
window.close();
}else{
//do things here
}
}
});
//return false; //阻止表單的預設提交事件
});
</script>
三、submit方式2
<html>
<head>
<script type="text/javaScript">
jQuery(document).ready(function (){
jQuery('#search_form').bind("submit", function(){
var key_word = jQuery("#keyword").val();
if(key_word == ""){
return false;
}
var options = {
url: '/portrait/user_info_display?user_info_keyword=' + key_word,
type: 'post',
dataType: 'text',
data: $("#search_form").serialize(),
success: function (data) {
if (data.length > 0){
jQuery("#user_info").html(data);
}
}
};
$.ajax(options);
return false;
});
$('#search').click(function(){
$('#search_form').submit();
});
});
</script>
</head>
<body>
<form mothod="post" id="search_form">
<div class="cf">
<label class="search-bar">
<input id="keyword" placeholder="請輸入搜尋關鍵詞" name="user_info_keyword" type="text" value="" class="input-search">
<a id="search" class="btn-search">
<i class="icon-search"></i>
</a>
<a href="javascript:;" class="btn-more"></a>
</label>
</div>
</form>
</body>
</html>
程式碼完成了兩個功能:1.輸入關鍵詞後按回車,會向server傳送一個POST請求,然後非同步提交表單,重新整理部分頁面;2.輸入關鍵詞後,點選查詢按鈕,也可非同步重新整理部分頁面。
此時要注意表單提交後傳送的是POST請求,而點選按鈕會發送一個GET請求,所以我們可以通過jQuery,使得按鈕點選時觸發表單提交,這樣後端就不用再寫程式碼處理GET請求。
四、隱藏的iframe模擬非同步上傳
為什麼在這裡說的是模擬呢?因為我們其實是將返回結果放在了一個隱藏的iframe中,所以才沒有使當前頁面跳轉,感覺就像是非同步操作一樣。
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html lang="en">
<head>
<meta charset="UTF-">
<title>隱藏的iframe上傳檔案</title>
<script type="text/javascript" src="jquery路徑..."></script>
</head>
<body>
<iframe name="frm" style="display: none"></iframe>
<form action="/upload" enctype="multipart/form-data" method="post" target="frm" onsubmit="loading(true);">
<p id="upfile">
附件: <input type="file" name="myfile" style="display: inline">
</p>
<p id="upbtn">
<input style="padding-left: px; padding-right: px;" type="submit" value="非同步上傳">
<span id="uptxt" style="display: none">正在上傳...</span>
</p>
</form>
<div id="flist" style="border: px dotted darkgray;"></div>
<script>
// 上傳完成後的回撥
function uploadFinished(fileName) {
addToFlist(fileName);
loading(false);
}
function addToFlist(fname) {
var temp = ["<p id='" + fname + "'>",fname,"<button onclick='delFile(\""+fname+"\");'>刪除</button>","</p>"];
$("#flist").append(temp.join(""));
}
function loading(showloading) {
if (showloading) {
$("#uptxt").show();
} else {
$("#uptxt").hide();
}
}
</script>
</body>
</html>
這種技術有兩個關鍵的地方:
- form會指定target,提交的結果定向返回到隱藏的ifram中。(即form的target與iframe的name屬性一致)。
- 提交完成後,iframe中頁面與主頁面通訊,通知上傳結果及服務端檔案資訊.
如何與主頁面通訊呢?
我們用nodejs在接收完了檔案後返回了一個window.parent.主頁面定義的方法,執行後可以得知檔案上傳完成。程式碼很簡單:
router.post('/upload', multipartMiddleware, function(req, res) {
var fpath = req.files.myfile.path;
var fname = fpath.substr(fpath.lastIndexOf('\\') + );
setTimeout(function() {
var ret = ["<script>","window.parent.uploadFinished('"+fname+"');","</script>"];
res.send(ret.join(""));
}, );
});
五、使用XMLHttpRequest2來進行真正的非同步上傳
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-">
<title>xhr level 非同步上傳</title>
<script type="text/javascript" src="jquery路徑..."></script>
</head>
<body>
<div>
<p id="upfile">
附件: <input type="file" id="myfile" style="display: inline">
</p>
<p id="upbtn">
<input style="padding-left: px; padding-right: px;" type="button" value="非同步上傳" onclick="upload();">
<span id="uptxt" style="display: none">正在上傳...</span>
<span id="upprog"></span>
<button id="stopbtn" style="display: none;">停止上傳</button>
</p>
</div>
<div id="flist" style="border: px dotted darkgray;"></div>
<script>
function upload() {
// 準備FormData
var fd = new FormData();
fd.append("myfile", $("#myfile")[0].files[0]);
// 建立xhr物件
var xhr = new XMLHttpRequest();
// 監聽狀態,實時響應
// xhr 和 xhr.upload 都有progress事件,xhr.progress是下載進度,xhr.upload.progress是上傳進度
xhr.upload.onprogress = function(event) {
if (event.lengthComputable) {
var percent = Math.round(event.loaded / event.total);
console.log('%d%', percent);
$("#upprog").text(percent);
}
};
// 傳輸開始事件
xhr.onloadstart = function(event) {
console.log('load start');
$("#upprog").text('開始上傳');
$("#stopbtn").one('click', function() {
xhr.abort();
$(this).hide();
});
loading(true);
};
// ajax過程成功完成事件
xhr.onload = function(event) {
console.log('load success');
$("#upprog").text('上傳成功');
console.log(xhr.responseText);
var ret = JSON.parse(xhr.responseText);
addToFlist(ret.fname);
};
// ajax過程發生錯誤事件
xhr.onerror = function(event) {
console.log('error');
$("#upprog").text('發生錯誤');
};
// ajax被取消
xhr.onabort = function(event) {
console.log('abort');
$("#upprog").text('操作被取消');
};
// loadend傳輸結束,不管成功失敗都會被觸發
xhr.onloadend = function (event) {
console.log('load end');
loading(false);
};
// 發起ajax請求傳送資料
xhr.open('POST', '/upload', true);
xhr.send(fd);
}
function addToFlist(fname) {
var temp = ["<p id='" + fname + "'>",fname,"<button onclick='delFile(\"" + fname + "\");'>刪除</button>","</p>"];
$("#flist").append(temp.join(""));
}
function delFile(fname) {
console.log('to delete file: ' + fname);
// TODO: 請實現
}
function loading(showloading) {
if (showloading) {
$("#uptxt").show();
$("#stopbtn").show();
} else {
$("#uptxt").hide();
$("#stopbtn").hide();
}
}
</script>
</body>
</html>
程式碼有點多,但是通俗易懂。使用過AJAX的人都知道,XHR物件提供了一個onreadystatechange的回撥方法來監聽整個請求/響應過程。在XMLHttpRequest2級規範中又多了幾個進度事件。有以下6個事件:
1.loadstart: 在接收到響應資料的第一個位元組時觸發。
2.progress: 在接收響應期間持續不斷地觸發。
3.error: 在請求發生錯誤時觸發。
4.abort: 在因為呼叫abort()方法而終止連線時觸發。
5.load: 在接收到完整的響應資料時觸發。
6.loadend: 在通訊完成或者觸發error,abort,load事件後觸發。
這次我們可以解讀程式碼:當傳輸事件開始後,我們便在停止傳送按鈕上新增點選事件,內建了abort方法可以停止傳送。若不點則會正常上傳直到傳送完畢為止。其後臺程式碼類似第二種方法。