萬盛學電腦網

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

跨 Iframe 獲取 zTree 選中節點:父頁面操作子頁面樹元件完整指南

問題背景

許多管理後台將 zTree 放入 <iframe> 以隔離樣式與腳本。但父頁面按鈕(如「確定」、「導出」)需讀取子頁面樹元件的勾選狀態。本文說明跨 iframe 存取 zTree 實例的標準做法與相容性細節。

架構示意

<!-- 父頁面 -->
<iframe id="aa" name="aa" src="tree-page.html"></iframe>
<button id="btnGetChecked">取得選中節點</button>

<!-- 子頁面 tree-page.html -->
<div id="treeDemo"></div>
<script>
  var zTreeObj = $.fn.zTree.init($("#treeDemo"), setting, zNodes);
</script>

父頁面核心代碼

$('#btnGetChecked').on('click', function() {
  // 關鍵:window.frames['iframe_name'].window.zTreeObj
  var childWin = window.frames['aa'].window;  // 或 window.frames[0].window
  var zTreeObj = childWin.zTreeObj;           // 子頁面全域暴露的 zTree 實例
  var checkedNodes = zTreeObj.getCheckedNodes(true); // true = 僅勾選節點

  console.log('選中節點:', checkedNodes);
  // 後續處理:送往後端、顯示彈窗等
});

關鍵點與坑點

  1. iframe 必須同源(同協定、域名、埠),否則瀏覽器同源策略會阻擋存取 contentWindow。
  2. id 與 name 同值:<iframe id="aa" name="aa">,兼容 IE 老版本透過 window.frames['name'] 取得視窗物件。
  3. 子頁面需暴露實例:var zTreeObj = ... 掛在 window 上,或掛在自定義命名空間 window.myTree = zTreeObj 避免汙染全域。
  4. 動態載入 iframe 時,務必在 iframe.onload 後再嘗試存取,否則實例尚未初始化。

完整父頁面範例

<!DOCTYPE html>
<html>
<head><meta charset="utf-8"><title>父頁面</title></head>
<body>
  <iframe id="treeFrame" name="treeFrame" src="tree.html" style="width:100%;height:400px;"></iframe>
  <button id="getChecked">取得勾選節點</button>
  <pre id="output" style="background:#f5f5f5;padding:10px;"></pre>

  <script src="https://cdn.bootcdn.net/ajax/libs/jquery/3.6.0/jquery.min.js"></script>
  <script>
    $('#getChecked').on('click', function() {
      try {
        var treeWin = window.frames['treeFrame'].window;
        var nodes = treeWin.zTreeObj.getCheckedNodes(true);
        var ids = nodes.map(function(n) { return n.id; }).join(',');
        $('#output').text('IDs: ' + ids + '\n\n完整物件:\n' + JSON.stringify(nodes, null, 2));
      } catch (e) {
        alert('跨域或實例未就緒:' + e.message);
      }
    });
  </script>
</body>
</html>

替代方案:postMessage(跨域適用)

若父子頁面不同源,請改用 window.postMessage:子頁面監聽 message 事件,收到指令後回傳節點資料;父頁面發送指令並接收回應。此做法更安全、現代化。

結語

同源情境下,window.frames['name'].window.zTreeObj.getCheckedNodes() 是最直接、效能最好的取值方式;跨域則請採用 postMessage 機制。

copyright © 萬盛學電腦網 all rights reserved