把常用的請求流程包成一個類別,之後呼叫就能少寫一堆重複的跨瀏覽器判斷。以下是這個封裝後 Ajax 類別的用法與參數說明。
new AJax().Request(url, cmd, async, method, postString, title)
· url:請求頁面的網址(必填)
· cmd:回傳值的處理函式(必填)
· async:是否非同步,true|false,預設 true
· method:請求方式,post|get,預設 get
· postString:請求方式為 post 時要送出的內容
· title:請求內容的標題(會顯示在提示列)
// AJax 封裝 2007-3-13
function createXMLHttpRequest() {
try {
if (window.XMLHttpRequest) {
return new XMLHttpRequest();
}
else if (window.ActiveXObject) {
return new ActiveXObject("Microsoft.XMLHTTP");
}
}
catch (e) {alert("XMLHttpRequest對象無法創建!請檢查IE安全設置!");}
}
接著是一個 messageDiv 建構函式,負責在頁面左下角動態產生一個帶狀態文字與小圖示的提示列,並提供 clear()(移除自己並重排其他提示列)與 showmsg()(顯示並更新訊息)兩個方法:
function messageDiv(t) {
var v = document.createElement("<div>");
v.innerHTML = "<table style=\"width:300px;\" id=message>" +
"<tr style=\"font-size:12px;background-color:#EEEEff;color:#227933;height:20px\">" +
"<td style=\"padding:2px;border-top:1px solid #E1E1E1;border-left:1px solid #E1E1E1;border-bottom:1px solid #818181;border-right:1px solid #A1A1A1\">" +
"<nobr><img src=https://www.pushad.com/Info/refresh.gif align=absmiddle> " +
t + ",<span id=Span1>連接未初始化...</span></nobr></td></tr></table>";
var l = document.getElementsByName("message").length;
v.style.cssText = "position:absolute;bottom:" + (l*24) + "px;left:0px;display:none";
document.body.appendChild(v);
this.clear = function () {
document.body.removeChild(v);
var msg = document.getElementsByName("message");
for (var i=0;i<msg.length;i++){
msg[i].parentNode.style.cssText = "position:absolute;bottom:" + (i*24) + "px;left:0px";
}
}
this.showmsg = function (s) {
v.style.display = "";
v.all.Span1.innerHTML = s;
}
}
最後是 AJax 類別本體。Request 方法先整理各參數的預設值,建立提示列,再依 readyState 狀態(1 初始化、2 發送、3 接收、4 完成)顯示對應的提示文字;完成後若 status 為 200 就呼叫 cmd 處理回應並清除提示列,否則顯示錯誤訊息並在 3 秒後自動關閉。同時它也兼顧同步/非同步兩種情境:
function AJax() {
var x = new createXMLHttpRequest();
this.Request = function (url,cmd,async,method,postString,title) {
if (method!="post") method = "post"; else method = "get";
if (async!=true) async = true; else async = false;
if (typeof(postString)!="string") postString="";
if (typeof(title)!="string") title="正在獲取數據"; else title="正在獲取" + title;
var msgbox = new messageDiv(title);
x.onreadystatechange = function () {
if (async) switch (x.readyState) {
case 1: msgbox.showmsg("正在初始化連接..."); return;
case 2: msgbox.showmsg("正在發送數據..."); return;
case 3: msgbox.showmsg("正在接收數據..."); return;
case 4:
msgbox.showmsg("數據接收完成...");
if (x.status == 200) {
cmd(x.responseText);
msgbox.clear();
}
else {
msgbox.showmsg("請求失敗," + x.statusText + "(" + x.status + ")");
setTimeout(msgbox.clear,3000);
}
return;
}
x.open (method,url,async);
if (method=="post") {msgbox.showmsg("正在接收數據...");x.send(postString);} else x.send();
if (!async) {
msgbox.showmsg("數據接收完成...");
cmd(x.responseText);
msgbox.clear();
}
}
}
整體來說,這個類別把「建立物件、切換請求方式、顯示即時狀態、處理成功/失敗」等繁瑣細節都收攏在一個 Request 呼叫裡,並用提示列清楚呈現每個階段的進度,讓 Ajax 請求的呼叫變得乾淨又直覺。