萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

jQuery load() 方法加載外部頁面指定片段完整指南

jQuery load() 遠程片段注入:AJAX 頁面局部更新核心技巧

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>

demo_test.txt 內容示例


<div id="p1">
  <h3>這是片段 1</h3>
  <p>只會載入這個 div 內的內容</p>
</div>
<div id="p2">
  <p>這部分不會被載入</p>
</div>

底層原理:$.ajax + DOM 片段提取


// 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); } }); }); };

實戰應用場景

  1. 公共組件複用:Header/Footer 統一維護,各頁 $('#header').load('/common/header.html')
  2. 標籤頁懶加載:切換 Tab 時 $panel.load('tab-content.html .panel-body')
  3. 分頁無刷新:$list.load('/api/list?page=2 .item')
  4. 舊系統前端解耦:後端渲染完整頁,前端按需提取片段
  5. 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 + 選擇器」語法與片段提取原理,能靈活解決前端片段化組裝需求。

copyright © 萬盛學電腦網 all rights reserved