AJAXRequest 是一個輕量級的 Ajax 應用程式開發框架,相容 Firefox、IE、Opera、Safari,可以方便地進行 Ajax 中經常需要的操作,簡化開發步驟、減少重複程式碼。這一版(v0.7.12,2007-12-31)改動不少,以下逐項說明。
stopupdate 方法。update 方法的返回值為更新請求 ID,用於停止更新。postf 方法的表單驗證屬性 onsubmit 為 onvalidate。postf 方法的參數為 post(form, [callback]),移除 action 與 method 參數。post 方法參數 content 預設值未沿用全域 content 屬性的問題。postf 方法傳送「+」時接收端變成空格的問題。AJAXRequest 類別建構參數中 onrequeststart 與 onrequestend 名稱錯誤的問題。舊版 update 回傳的是計時器 ID,因此要用 clearInterval() 停止更新。新版改為回傳更新請求 ID,停止動作交由 stopupdate 負責。
另一個改變是:不限次數更新與限次數更新都會回傳 ID,也就是說即使設定了更新次數,在達到上限之前同樣可以用 stopupdate 中途喊停。
var ajax = new AJAXRequest();
var u;
// 開始以間隔 1 秒、不限次數地從 test.asp 更新 updateObj
function start() {
u = ajax.update("updateObj", "test.asp", 1000);
}
// 停止更新
function stop() {
ajax.stopupdate(u);
}
把 onsubmit 用於表單驗證可能與某些應用衝突,因此改用專屬的 onvalidate:
<form action="test.asp" method="post" onvalidate="return checkForm();"> </form>
參數限定為表單物件與回呼函式,action 與 method 必須在 form 標籤中指定:
// form 標籤的 action 和 method 屬性必須指定 <form action="test.asp" method="post"> </form>
清單裡最不起眼的一項其實最有教育意義:postf 傳送「+」時接收端變成空格。這正是 application/x-www-form-urlencoded 編碼規則的必然結果——空格會被編碼成 +,所以反過來說,未編碼的 + 就會被還原成空格。框架必須在送出前把參數完整編碼(+ → %2B),否則使用者輸入的任何加號都會憑空消失。這個 bug 在無數自製 Ajax 函式庫裡重複出現過,值得記住。
若在使用中發現問題或有建議,可來信 vipxjw[at]163[dot]com。
順帶一提,清單第 8 項「修正使用同步方式傳送請求」也值得留意:同步請求會凍結整個使用者介面直到回應到來,是造成「網頁當掉」的常見原因。今天的做法是一律使用非同步,並在等待期間顯示載入狀態。