萬盛學電腦網

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

ExtJS Tree 重載後自動恢復選中節點:使用 getPath 與 expandPath

需求背景

TreePanel 節點操作(新增/編輯/刪除)後通常需 reload() 更新樹狀結構,但業務要求重載後自動選中操作前的節點,並展開其祖先路徑。

核心思路

  1. 操作前取得選中節點的 path(基於唯一 id 屬性)。
  2. 重載樹的根節點。
  3. 重載完成後,呼叫 expandPath(path, 'id', callback) 逐層展開並選中。

ExtJS 3.x 寫法

var node = tree.getSelectionModel().getSelectedNode();
if (!node) {
  tree.getRootNode().reload(); // 無選中直接重載
} else {
  var path = node.getPath('id'); // 取得路徑,如 "/root/1/5/12"
  
  tree.getLoader().load(tree.getRootNode(), function() {
    tree.expandPath(path, 'id', function(success, lastNode) {
      if (success && lastNode) {
        tree.getSelectionModel().select(lastNode);
      }
    });
  });
}

ExtJS 4.2+ 寫法(現代 Store 架構)

var selNode = tree.getSelectionModel().getSelection()[0];
if (selNode) {
  var idPath = selNode.getPath("id");
  
  tree.getStore().load({
    node: tree.getRootNode(),
    callback: function() {
      tree.expandPath(idPath, 'id', function(success, lastNode) {
        if (success && lastNode) {
          tree.getSelectionModel().select(lastNode);
        }
      });
    }
  });
} else {
  tree.getStore().load(); // 直接重載
}

關鍵前提:節點必須有 id 屬性

getPath('id') 依賴節點擁有 id 欄位。若後端回傳資料無 id,需在模型定義或資料處理階段補上:

// Model 定義
Ext.define('TreeNode', {
  extend: 'Ext.data.Model',
  fields: ['id', 'text', 'parentId', 'leaf'] // 必須有 id
});

// 或在 proxy reader 轉換
proxy: {
  type: 'ajax',
  reader: {
    type: 'json',
    rootProperty: 'data',
    transform: function(data) {
      return data.map(function(node, i) {
        return Ext.apply({ id: node.id || 'node_' + i }, node);
      });
    }
  }
}

常見問題排查

現象可能原因解決方案
expandPath 失敗、不展開path 中 id 不存在或不唯一確保後端回傳唯一 id,且父子關係正確
選中節點不正確多個節點 id 重複保證全樹 id 唯一
callback 不執行store.load 未完成或節點未渲染使用 load 事件或 callback 確保同步
效能差(大樹)遞迴展開耗時分頁載入、虛擬滾動、延遲渲染

進階:保存更多狀態(展開/選中/捲動位置)

// 保存完整 UI 狀態
function saveTreeState(tree) {
  var sm = tree.getSelectionModel();
  var selNode = sm.getSelection()[0];
  var expanded = [];
  tree.getRootNode().cascadeBy(function(node) {
    if (node.isExpanded()) expanded.push(node.getPath('id'));
  });
  return {
    selectedPath: selNode ? selNode.getPath('id') : null,
    expandedPaths: expanded,
    scrollTop: tree.getView().getEl().getScroll().top
  };
}

// 恢復狀態
function restoreTreeState(tree, state) {
  tree.getStore().load({
    callback: function() {
      // 1. 恢復展開路徑
      state.expandedPaths.forEach(function(path) {
        tree.expandPath(path, 'id');
      });
      // 2. 恢復選中
      if (state.selectedPath) {
        tree.expandPath(state.selectedPath, 'id', function(success, node) {
          if (success) tree.getSelectionModel().select(node);
        });
      }
      // 3. 恢復捲動
      tree.getView().getEl().scrollTo('top', state.scrollTop);
    }
  });
}
copyright © 萬盛學電腦網 all rights reserved