本文示範如何以 jQuery 的 load() 方法做局部刷新。方法本身很簡單,真正的功夫在於怎麼把它接進 jfinal 與 Bootstrap 組成的公共專案裡,還要同時兼顧「重新整理網址列」的情境。
$p.load(url, data, function(response, status, xhr))

我們要提供的 Ajax 回呼函式,至少需要 url 與 jQuery 物件這兩個參數。但還有另一個情境不能忽略:使用者可能直接在網址列重新整理。
location.href
所以我們還需要第三個參數,用來告訴前端「這次操作該跳到哪個網址」。
// 局部加載 String elementId = getPara("elementId"); String loadPage = getPara("loadPage"); // 地址欄跳轉路徑 String locationUrl = getPara("locationUrl"); setAttr("elementId", elementId); setAttr("loadPage", loadPage); setAttr("locationUrl", locationUrl); <a href="${ctx}/mem/logout?elementId=log_tip&loadPage=header_login_tip" <form class="pop_login_form" action="${ctx}/mem/login?callbackType=closeCurrent&elementId=log_tip&loadPage=header_login_tip"
三個參數的分工是:
elementId:局部刷新時,要更新畫面上哪個元素的 id。loadPage:要載入的局部檢視名稱。locationUrl:需要整頁跳轉時的目標網址。要注意的是:jfinal 端要把這三個屬性封裝好交給前端;jsp 端則要把對應的參數如實傳給 jfinal。兩邊的欄位名稱必須對得上,否則前端拿到 undefined 就會靜默失敗。
function dialogAjaxDone(json) { YUNM.ajaxDone(json); if (json[YUNM.keys.statusCode] == YUNM.statusCode.ok || json[YUNM.keys.statusCode] == YUNM.statusCode.info) { if ("closeCurrent" == json.callbackType) { close_pop(); } if (json.locationUrl) { location.href = json.locationUrl; } else { // 如果指定了後調轉頁面,進行調轉 $("#" + json.elementId).load(common.loadPath + json.loadPage + common.viewType); } } }
這個函式的判斷順序值得留意:先關閉彈窗,再看要不要整頁跳轉,最後才做局部刷新。這個順序有其道理——如果本次操作的結果是登出,那後續的局部刷新毫無意義,直接跳走就好;只有不需要跳轉時,才值得去載入新的片段。把整頁跳轉的判斷放在局部刷新之前,可以省下一次無效請求。
要用 load(),就必須確保被載入的那個片段頁面,其所有依賴(CSS、JS)在主頁面中都已經引入齊全。因為 load() 只會把 HTML 片段塞進 DOM,不會重新執行 <head> 裡的資源宣告,也不會自動執行片段內插入的 script(視 jQuery 版本而異)。這是這個方案最容易踩到的坑。
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "https://www.w3.org/TR/html/loose.dtd"> <html xmlns="https://www.w3.org/1999/xhtml"> <%@ page language="java" contentType="text/html; charset=utf-8" pageEncoding="utf-8"%> <%@ include file="/components/common/taglib.jsp"%> <script type="text/javascript"> $("a[target=ajaxTodo]").ajaxTodo(); </script> <div> <c:choose> <c:when test="${sessionScope.username!=null}"> <a href="javascript:void();" id="mycenter" style=""> ${sessionScope.username}<s class="icon_arrow icon_arrow_down"></s> </a> <i class="line"></i> <a href="${ctx}/mem/logout?elementId=log_tip&loadPage=header_login_tip" target="ajaxTodo" callback="ajaxDone" atitle="你確定要退出嗎?" id="user_login_out" style="padding: px;">退出</a>
關鍵是「同一個後端 action 同時服務兩種情境」:使用者點連結時走局部刷新,畫面不閃、其餘狀態保留;重新整理或分享網址時走整頁載入,內容依然正確。這比純 Ajax 方案(重新整理就空白)友善得多,也比純整頁方案(每次都要重載全部資源)流暢得多。
若專案允許,其實可以考慮直接採用 pjax 這類成熟方案——它內建了 history 對接、瀏覽器前後頁支援與降級處理,能省下不少自製框架的維護成本。自製的價值在於完全掌控行為,代價則是所有邊界情況都得自己想到。