萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

EasyUI Tabs update 方法正確用法:動態重載分頁內容避坑指南

問題背景

jQuery EasyUI 的 tabs('update') 方法常被誤用,導致分頁內容不更新、iframe 重複載入或事件綁定失效。官方文檔參數說明較簡略,本文總結正確調用模式。

錯誤用法 vs 正確用法

❌ 常見錯誤

// 錯誤 1:直接傳遞 href 字串
$('#tt').tabs('update', { href: 'new_page.php' });

// 錯誤 2:缺少 tab 參數
$('#tt').tabs('update', {
    options: { href: 'new_page.php' }
});

✅ 正確完整參數結構

function updateTab(url) {
    // 1. 取得當前選中的分頁 panel 物件
    var tab = $('#tt').tabs('getSelected');

    // 2. 呼叫 update,必須包含 tab 物件與 options 物件
    $('#tt').tabs('update', {
        tab: tab,                    // 必填:目標分頁的 jQuery 物件
        options: {
            href: url,               // 新內容 URL (適用 href 模式)
            // cache: false,         // 可選:禁用快取
            // onLoad: function() {} // 可選:載入完成回呼
        }
    });

    // 3. 關鍵:若內容為 iframe 或需強制重新載入,需手動觸發 panel refresh
    tab.panel('refresh');
}

參數詳解

參數類型必要說明
tabjQuery Object是tabs('getSelected') 或 tabs('getTab', index) 取得的 panel 物件
options.hrefString否遠端內容 URL,contentType: 'iframe' 時為 iframe src
options.contentString否直接指定 HTML 內容 (與 href 二擇一)
options.titleString否更新分頁標題
options.closableBoolean否是否可關閉
options.iconClsString否圖示 CSS 類別

完整互動範例

<!DOCTYPE html>
<html>
<head>
  <meta charset="utf-8">
  <link rel="stylesheet" href="https://www.jeasyui.com/easyui/themes/default/easyui.css">
  <script src="https://code.jquery.com/jquery-3.6.0.min.js"></script>
  <script src="https://www.jeasyui.com/easyui/jquery.easyui.min.js"></script>
</head>
<body>
  <div id="tt" class="easyui-tabs" style="width:600px;height:300px;">
    <div title="首頁" href="home.php" style="padding:10px;"></div>
    <div title="報表" href="report.php" style="padding:10px;"></div>
  </div>

  <button onclick="reloadTab('report_v2.php')">重新載入報表</button>
  <button onclick="changeTabTitle('新標題')">修改標題</button>

  <script>
    function reloadTab(url) {
      var tab = $('#tt').tabs('getSelected');
      if (!tab) return alert('請先選擇分頁');

      $('#tt').tabs('update', {
        tab: tab,
        options: { href: url, cache: false }
      });
      tab.panel('refresh'); // 強制重載
    }

    function changeTabTitle(newTitle) {
      var tab = $('#tt').tabs('getSelected');
      if (!tab) return;
      $('#tt').tabs('update', {
        tab: tab,
        options: { title: newTitle }
      });
    }
  </script>
</body>
</html>

進階場景處理

場景 A:更新非當前分頁

// 依索引更新第 2 個分頁 (索引從 0 開始)
var tab = $('#tt').tabs('getTab', 1);
$('#tt').tabs('update', {
    tab: tab,
    options: { href: 'other.php' }
});

場景 B:iframe 模式分頁更新

<div title="外部系統" href="https://example.com" data-options="contentType:'iframe'"></div>

// 更新 iframe src
var tab = $('#tt').tabs('getTab', '外部系統');
$('#tt').tabs('update', {
    tab: tab,
    options: { href: 'https://another.com' }
});
tab.panel('refresh'); // 觸發 iframe src 變更

場景 C:內容模式 更新純 HTML

var tab = $('#tt').tabs('getSelected');
$('#tt').tabs('update', {
    tab: tab,
    options: {
        content: '<h3>即時更新內容</h3><p>' + new Date() + '</p>'
    }
});

常見坑點排查

  • 內容不更新:漏寫 tab.panel('refresh') 或 cache: false 未生效 (需 EasyUI 1.5+)
  • 事件失效:update 後原分頁綁定的事件隨 DOM 銷毀,需在 onLoad 回呼中重新綁定
  • 巢狀 Tabs:內層 tabs 選取器需精確 $('#inner-tabs').tabs('update', ...)
  • 跨域 iframe:受同源策略限制,無法從父頁面操作 iframe 內部 DOM

版本差異提醒

  • EasyUI 1.4.x:update 參數結構不同,建議升級至 1.5.2+
  • 1.5+ 版本支援 cache 選項控制 AJAX 快取

掌握 tab + options + refresh 三步驟,即可穩定控制 EasyUI Tabs 動態內容更新。

copyright © 萬盛學電腦網 all rights reserved