load() 是 jQuery 中最省事的 Ajax 方法:一行就能把遠端 HTML 塞進頁面。但它的參數行為有幾個不直觀的地方。
load( url [, data] [, callback] )
url:要匯入檔案的網址。
data(選填):load 不只載入靜態 HTML,也能載入 PHP 等動態腳本,要傳的參數放在這裡。關鍵:帶 data 則用 POST,不帶則用 GET。
callback(選填):取得回應後要執行的函式,簽名為 function(responseText, textStatus, jqXHR)。
// 1. 載入不含參數的 php
$("#myID").load("test.php");
// 2. 含一個參數,等同 test.php?name=Adam
$("#myID").load("test.php", { "name": "Adam" });
// 3. 含多個參數,以逗號分隔
$("#myID").load("test.php", { "name": "Adam", "site": "61dh.com" });
// 4. 以陣列作為參數
$("#myID").load("test.php", { "myinfo[]": ["Adam", "61dh.com"] });
務必注意:使用 load 傳參數時是以 POST 方式送出,因此 test.php 裡不能用 GET 取值,要改用 POST。這點經常被忽略,導致後端永遠收到空值。
想在內容載入後加個淡入效果:
$("#go").click(function () {
$("#myID").load("welcome.php", { "lname": "Cai", "fname": "Adam" }, function () {
$("#myID").fadeIn('slow');
});
});
回呼函式可接三個參數,除錯時很有用:
$("#myID").load("welcome.php", function (response, status, xhr) {
if (status == "error") {
console.log("載入失敗:", xhr.status, xhr.statusText);
}
});
注意 jQuery 的 load 在錯誤時仍會呼叫 callback(status 為 "error"),這與 $.ajax 的 success 不同,是很多人漏處理的地方。
更新 labels.html 後,IE7 中的 load 仍舊使用舊檔,按重新整理也沒用。全域關閉 Ajax 快取:
$.ajaxSetup({
cache: false // 關閉 AJAX 相關的快取
});
其他幾種做法:
1. 更改檔名,例如 labels.html 改成 labels_new.html。這是下下策,但確實有效。
2. 網址加時間參數,例如 labels.html?20260831。更新 CSS 與 JavaScript 時我都用這招。建置流程中自動附加雜湊是最理想的版本。
3. 檔案頂端加 meta 宣告:
<META HTTP-EQUIV="Pragma" CONTENT="no-cache">
<META HTTP-EQUIV="Expires" CONTENT="-1">
但 HTML5 規範已明言不要這樣做,實際效果在現代瀏覽器中不可靠。請用伺服器端標頭。
4. 在 PHP 中設定標頭:
<?php
header("Cache-Control: no-cache, must-revalidate");
?>
在 url 後空一格再接選擇器,可以只插入符合該選擇器的片段:
// 只取 test.html 中 id 為 a 的元素內容
$("body").load("test.html #a");
這個功能很實用——後端輸出完整的 HTML 頁面,前端只挑需要的區塊插入,不必為了片段而另開一個 API 端點。
腳本不會自動執行。load 插入的 script 標籤在 jQuery 中會被移除並評估執行,但外鏈 script 的載入時機不一定如預期。需要執行初始化時,放在 callback 裡最保險。
XSS 風險。load 內部使用 innerHTML,載入的內容若含使用者可控資料,必須先 sanitize。
無法設定 HTTP 標頭。需要帶 Authorization 或自訂標頭時,load 做不到,得改用 $.ajax。
已被 fetch 取代。新專案建議:
const html = await (await fetch('/blog/categories/labels.html')).text();
document.getElementById('labels').innerHTML = html;