碰到耗時的查詢或運算,使用者最怕的是「點了之後什麼都沒發生」。這時候一個簡單的載入提示就能大幅改善感受。xajax 內建了兩個掛勾,讓這件事不必自己攔截請求。
在 body 開頭放兩個 div,外層當容器,內層放提示文字:
<div id="loadingContainer"> <div id="loading">正在載入資料,請稍候</div> </div>
xajax 提供 loadingFunction 與 doneLoadingFunction 兩個屬性,分別對應「請求送出後、等待回應」與「回應已到達」這兩個時間點。把上面那層的顯示狀態綁上去就好:
var loadingpic = document.getElementById('loadingContainer');
loadingpic.style.display = 'none'; // 初始隱藏
xajax.loadingFunction = loading; // 等待回應時呼叫
xajax.doneLoadingFunction = loadingDone; // 收到資料後呼叫
function loading() {
loadingpic.style.display = 'block';
}
function loadingDone() {
loadingpic.style.display = 'none';
}
如果希望提示只在某些請求出現,而不是每次請求都跳,可以在函數裡多加一個旗標變數,由呼叫端自行控制是否顯示。
先在 PHP 端註冊一個費時的函數:
function slow_function() {
// 這裡放耗時的處理程序
}
$xajax = new xajax();
$xajax->register(Xajax_FUNCTION, 'slow_function');
$xajax->processRequest();
前端只要呼叫對應的 stub 函數即可,提示層會自動在請求期間出現、結束後消失:
<a href="#" onclick="xajax_slow_function(); return false;">點我試試</a>
提示層建議用 CSS 絕對定位並加上半透明遮罩,同時把 z-index 設高,這樣使用者會自然理解「現在不能操作」。另外記得在 doneLoadingFunction 之外,也考慮請求失敗的情況——若伺服器回錯誤或逾時,提示若不收掉,畫面就會永遠卡在載入中。