load(url, selector, callback) 是 jQuery 最高級的 AJAX 方法:請求 URL、提取選擇器匹配片段、注入目標元素。一行代碼實現「頁面片段包含」,是構建 SPA 偽裝、Widget 嵌入、舊系統前端解耦的利器。
// 完整語法
$(target).load(url, [data], [callback]);
// 核心特性:URL 後附加空格 + 選擇器
$('#result').load('page.html #fragment-id'); // 只提取 #fragment-id 內容
// 帶數據 POST
$('#result').load('api.php', { action: 'list', page: 1 });
// 回調函數
$('#result').load('page.html', function(response, status, xhr) {
if (status === 'error') console.error('加載失敗:', xhr.status);
});
<!DOCTYPE html>
<html>
<head>
<script src="js/jquery.min.js"></script>
<script>
$(document).ready(function(){
$("button").click(function(){
// 載入 demo_test.txt 中 id="p1" 的元素內容到 #div1
$("#div1").load("demo_test.txt #p1");
});
});
</script>
</head>
<body>
<div id="div1"><h2>使用jQuery AJAX改變此處內容</h2></div>
<button>改變外部內容</button>
</body>
</html>
<div id="p1">
<h3>這是片段 1</h3>
<p>只會載入這個 div 內的內容</p>
</div>
<div id="p2">
<p>這部分不會被載入</p>
</div>
// load() 內部簡化邏輯
$.fn.load = function(url, data, callback) {
const selector = url.split(' ')[1]; // 解析 "url #selector"
const realUrl = url.split(' ')[0];
return this.each(function() {
const $this = $(this);
$.ajax({
url: realUrl,
data: data,
success: function(html) {
// 創建臨時容器解析 HTML
const $doc = $('').html(html);
// 提取片段
const content = selector ? $doc.find(selector).html() : html;
$this.html(content);
callback && callback.call(this, content, 'success', xhr);
},
error: function(xhr, status) {
callback && callback.call(this, '', status, xhr);
}
});
});
};
實戰應用場景
- 公共組件複用:Header/Footer 統一維護,各頁
$('#header').load('/common/header.html')
- 標籤頁懶加載:切換 Tab 時
$panel.load('tab-content.html .panel-body')
- 分頁無刷新:
$list.load('/api/list?page=2 .item')
- 舊系統前端解耦:後端渲染完整頁,前端按需提取片段
- Widget 嵌入:第三方頁面嵌入 ``
關鍵限制與避坑
限制 說明 解決方案
同源策略 跨域需 CORS 或 JSONP 後端配置 Access-Control-Allow-Origin
腳本執行 載入片段中 <script> 會執行但不保留 避免在片段放邏輯,用回調初始化
樣式隔離 載入的 style 會汙染當前頁 使用 Shadow DOM 或 CSS Modules
相對路徑失效 片段中相對圖片/鏈接路徑基於當前頁 後端輸出絕對路徑或 base href
錯誤處理 網絡失敗靜默失敗 必須提供 callback 處理 error 狀態
現代替代:Fetch + DOMParser
async function loadFragment(targetSel, url, fragmentSel) {
const res = await fetch(url);
const html = await res.text();
const doc = new DOMParser().parseFromString(html, 'text/html');
const content = fragmentSel ? doc.querySelector(fragmentSel).innerHTML : html;
document.querySelector(targetSel).innerHTML = content;
}
// 使用
loadFragment('#div1', 'demo_test.txt', '#p1');
load() 是 jQuery 最具特色的 AJAX 封裝,理解其「URL + 選擇器」語法與片段提取原理,能靈活解決前端片段化組裝需求。
- 上一篇程序編程: jQuery 實現鼠標懸停圖片放大鏡效果完整教學
- 下一篇程序編程: jQuery 設置元素寬高:.width()/.height() 方法完整指南