萬盛學電腦網

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

jQuery 一鍵切換 Iframe 載入不同頁面:完整實作與最佳實踐

核心需求:點擊按鈕動態載入指定 URL 到 Iframe

常見於後台管理系統左側選單點擊、右側 iframe 顯示對應頁面。原始碼使用 jQuery `attr('src', url)` 即可實現,但需注意跨域限制與錯誤處理。

最精簡可用代碼

<!DOCTYPE html>
<html lang="zh-Hant">
<head>
  <meta charset="UTF-8">
  <title>Iframe 動態載入示範</title>
  <style>
    #contentFrame { width: 100%; height: 600px; border: 1px solid #ddd; }
    .btn-group { margin-bottom: 12px; }
    button { margin-right: 8px; padding: 6px 14px; cursor: pointer; }
  </style>
</head>
<body>
  <div class="btn-group">
    <button data-url="https://developer.mozilla.org/">MDN</button>
    <button data-url="https://web.dev/">web.dev</button>
    <button data-url="https://caniuse.com/">Can I Use</button>
    <button data-url="https://httpbin.org/get">測試 API</button>
  </div>
  <iframe id="contentFrame" src="about:blank" title="內容區"></iframe>

  <script src="https://cdn.jsdelivr.net/npm/jquery@3.7.1/dist/jquery.min.js"></script>
  <script>
    $(function() {
      $('.btn-group button').on('click', function() {
        const url = $(this).data('url');
        $('#contentFrame').attr('src', url);
      });
    });
  </script>
</body>
</html>

進階:錯誤處理與載入狀態

$('.btn-group button').on('click', function() {
  const $btn = $(this).prop('disabled', true).text('載入中…');
  const url = $btn.data('url');
  const $frame = $('#contentFrame');

  $frame.off('load.error').on('load.error', function() {
    $btn.prop('disabled', false).text($btn.data('original-text'));
  }).attr('src', url);
});

// 初始化按鈕原始文字
$('.btn-group button').each(function() {
  $(this).data('original-text', $(this).text());
});

跨域限制說明

場景結果解決方案
同源(同協議/域名/埠)父頁可操作 iframe 內 DOM直接存取 `contentWindow.document`
不同源父頁**無法**讀取/操作 iframe 內容用 `postMessage` 雙向通訊
目標頁面設 `X-Frame-Options: DENY`瀏覽器拒絕載入無法繞過,需目標站點配合設 `ALLOW-FROM`
目標頁面設 `Content-Security-Policy: frame-ancestors 'none'`同樣被攔截同上

原生 JS 替代方案(零依賴)

document.querySelectorAll('.btn-group button').forEach(btn => {
  btn.addEventListener('click', () => {
    document.getElementById('contentFrame').src = btn.dataset.url;
  });
});

效能與 UX 小技巧

  • 預載入:`link rel="prefetch" href="target.html"` 於滑鼠 hover 時預先抓取。
  • 骨架屏:iframe 載入前顯示 Skeleton UI,`onload` 後淡入。
  • 沙箱化:`