幾個月前因為專案需求寫了下面三個 Ajax 相關函式,整理出來分享。
要先說明的是:無刷新表單提交無法處理檔案上傳,這主要是瀏覽器的安全限制。目前無刷新上傳一般是靠 iframe 實作,這個主題搜尋一下能找到很多討論。
網路上優秀的 Ajax 類別與函式已經很多,但或許這幾個還派得上用場,於是就放出來了。
作者:SurfChen <surfchen@gmail.com> https://www.surfchen.org/ GPL
/**
* 以 XMLhttp 載入一段 HTML,並顯示在指定容器
* @param url 要載入的網址,例如 "index.php"
* @param request 要送出的請求字串,例如 "action=1&name=surfchen"
* @param method POST 或 GET
* @param container 容器物件,載入的內容會寫進 container.innerHTML
*/
function AJaxLoadPage(url, request, method, container) {
method = method.toUpperCase();
var loading_msg = 'Loading...';
var loader = new XMLHttpRequest(); // 需跨瀏覽器實作
if (method == 'GET') {
var urls = url.split("?");
if (urls[1] == '' || typeof urls[1] == 'undefined')
url = urls[0] + "?" + request;
else
url = urls[0] + "?" + urls[1] + "&" + request;
request = null; // GET 時 send 必須是 null
}
loader.open(method, url, true);
if (method == "POST")
loader.setRequestHeader("Content-Type", "application/x-www-form-urlencoded");
loader.onreadystatechange = function () {
if (loader.readyState == 1) container.innerHTML = loading_msg;
if (loader.readyState == 4) container.innerHTML = loader.responseText;
};
loader.send(request);
}
/**
* 把表單物件的所有欄位與值轉成請求字串(如 "action=1&name=surfchen")
* @param form_obj 表單物件
* 注意:此函式無法用於檔案上傳。若表單中有 file 欄位,會被當成文字欄位處理,
* 因為基於安全理由,多數瀏覽器不允許以 XMLhttp 上傳檔案,解法是 iframe。
*/
function formToRequestString(form_obj) {
var query_string = '';
var and = '';
for (var i = 0; i < form_obj.length; i++) {
var e = form_obj[i];
if (e.name == '') continue;
var element_value;
if (e.type == 'select-one') {
element_value = e.options[e.selectedIndex].value;
} else if (e.type == 'checkbox' || e.type == 'radio') {
if (e.checked == false) continue; // 未勾選就跳過
element_value = e.value;
} else {
element_value = e.value;
}
query_string += and + e.name + '=' + element_value.replace(/\&/g, "%26");
and = "&";
}
return query_string;
}
這裡把 checkbox 與 radio 未勾選的情形改成 continue 而非 break——原本用 break 會導致後面的欄位全部被丟掉,這是很典型的 bug。
/**
* 以 AJaxLoadPage + formToRequestString 實作無刷新送出
* @param form_obj 表單物件
* @param container 結果顯示的容器物件
*/
function AJaxFormSubmit(form_obj, container) {
AJaxLoadPage(
form_obj.getAttributeNode("action").value,
formToRequestString(form_obj),
form_obj.method,
container
);
}
用法一行解決:
AJaxFormSubmit(document.form1, document.getElementById('my_home'));
序列化時只處理了 &,其他特殊字元(=、+、#、中文與空白)並未編碼。正式環境請改用 encodeURIComponent(),逐一對欄位名稱與值編碼,這是避免參數被錯誤解析的關鍵。
另外,多選的 select(select-multiple)在這份實作中只會取到單一值。若要支援多選,得遍歷 e.options 並收集所有 selected 的項目,組成 name=v1&name=v2 的形式。