DIV CSS 佈局教程網

jQuery load() 用法全解:參數、回呼與快取
編輯:JavaScript綜合知識     

load() 是 jQuery 中最省事的 Ajax 方法:一行就能把遠端 HTML 塞進頁面。但它的參數行為有幾個不直觀的地方。

語法

load( url [, data] [, callback] )

url:要匯入檔案的網址。

data(選填):load 不只載入靜態 HTML,也能載入 PHP 等動態腳本,要傳的參數放在這裡。關鍵:帶 data 則用 POST,不帶則用 GET。

callback(選填):取得回應後要執行的函式,簽名為 function(responseText, textStatus, jqXHR)。

一、data 的四種用法

// 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。這點經常被忽略,導致後端永遠收到空值。

二、callback 的用法

想在內容載入後加個淡入效果:

$("#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");
?>

四、load 的特殊用法:只取部分內容

在 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;
XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved