萬盛學電腦網

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

jsMind 思維導圖啟用節點拖拽功能完整配置指南

jsMind 思維導圖拖拽調整節點位置功能啟用與客製化指南

jsMind 是純 JavaScript 實現的思維導圖庫,支援節點拖拽調整位置。本文詳細說明如何透過引入 jsmind.draggable.js 模組啟用拖拽功能,並提供進階配置、事件監聽與樣式客製化方案。

最小整合範例


<!-- 1. 核心樣式 -->
<link rel="stylesheet" type="text/css" href="css/jsmind.css" />

<!-- 2. 容器 -->
<div id="jsmind_container" style="width: 800px; height: 600px; border: 1px solid #ddd;"></div>

<!-- 3. 核心腳本 -->
<script type="text/javascript" src="js/jsmind.js"></script>

<!-- 4. 拖拽擴充模組 (關鍵) -->
<script type="text/javascript" src="js/jsmind.draggable.js"></script>

<script>
  // 思維導圖資料結構
  var mind = {
    "meta": { "name": "範例", "author": "user", "version": "0.1" },
    "format": "node_array",
    "data": [
      { "id": "root", "topic": "中心主題", "isroot": true },
      { "id": "node1", "parentid": "root", "topic": "分支 1" },
      { "id": "node2", "parentid": "root", "topic": "分支 2" },
      { "id": "node3", "parentid": "node1", "topic": "子節點 1-1" },
      { "id": "node4", "parentid": "node1", "topic": "子節點 1-2" }
    ]
  };
  
  var options = {
    container: 'jsmind_container',
    editable: true,        // 啟用編輯模式 (雙擊編輯文字)
    theme: 'primary',      // 主題: primary, orange, blue, green 等
    view: {
      hmargin: 100,        // 水平邊距
      vmargin: 50,         // 垂直邊距
      lineWidth: 2,        // 連線寬度
      lineColor: '#555'    // 連線顏色
    },
    layout: {              // 佈局方向
      hspace: 30,          // 水平間距
      vspace: 20,          // 垂直間距
      pspace: 10           // 父子間距
    },
    shortcut: {            // 快捷鍵配置
      handles: {           // 控制代碼
        addChild: 45,      // Insert
        addBrother: 13,    // Enter
        editNode: 113,     // F2
        delNode: 46,       // Delete
        toggle: 32         // Space
      },
      mapping: {           // 功能映射
        addChild: 'AddChild',
        addBrother: 'AddBrother',
        editNode: 'EditNode',
        delNode: 'DelNode',
        toggle: 'Toggle'
      }
    }
  };
  
  // 初始化
  var jm = new jsMind(options);
  jm.show(mind);
  
  // 拖拽功能已透過 jsmind.draggable.js 自動啟用
  // 無需額外代碼,節點即可拖拽移動位置
</script>

拖拽模組運作原理

jsmind.draggable.js 內部實現:

  1. 監聽節點元素的 mousedown/touchstart 事件
  2. 計算滑鼠相對節點偏移量
  3. mousemove/touchmove 時即時更新節點 x/y 座標
  4. 同步更新連線路徑 (SVG/Canvas)
  5. mouseup/touchend 確認位置,觸發 node_move 事件
  6. 支援撤銷/重做 (需配合 history 模組)

進階配置與事件監聽


// 監聽節點移動事件
jm.add_event_listener(function(type, data) {
  switch(type) {
    case 'node_move':
      console.log('節點移動:', data.node.id, '新位置:', data.node.x, data.node.y);
      // 可在此同步儲存至後端
      saveMindMapToServer(jm.get_data());
      break;
    case 'node_dragstart':
      console.log('開始拖拽:', data.node.id);
      // 可加入視覺反饋:高亮可放置區域
      break;
    case 'node_dragend':
      console.log('結束拖拽:', data.node.id);
      break;
  }
});

// 程式化控制拖拽權限
function setNodeDraggable(nodeId, draggable) {
  var node = jm.get_node(nodeId);
  if (node) {
    // jsMind 內部屬性,非公開 API,版本升級可能失效
    node._draggable = draggable; 
    // 更安全方式:CSS 控制
    // $('#' + nodeId).toggleClass('jmnode-undraggable', !draggable);
  }
}

// CSS 禁用特定節點拖拽

觸控裝置支援

jsMind.draggable 內建支援觸控事件:


// 確保容器觸控行為正確
#jsmind_container {
  touch-action: none; /* 防止瀏覽器預設滾動/縮攏干擾拖拽 */
}

// 多點觸控縮放 (需額外配置)
options.view.engine = 'svg'; // 或 'canvas'
options.view.zoom = 1;       // 初始縮放
options.view.zoomMin = 0.5;
options.view.zoomMax = 2;

樣式客製化:拖拽視覺回饋


/* 拖拽中節點樣式 */
.jmnode.jmnode-dragging {
  opacity: 0.8;
  transform: scale(1.02);
  box-shadow: 0 4px 12px rgba(0,0,0,0.15);
  z-index: 1000;
}

/* 可放置目標高亮 */
.jmnode.jmnode-drop-target {
  border: 2px dashed #4285f4;
  border-radius: 4px;
}

/* 拖拽手柄 (可選) */
.jmnode .jmnode-drag-handle {
  cursor: grab;
  width: 20px;
  height: 20px;
  background: url('drag-handle.svg') center no-repeat;
}
.jmnode .jmnode-drag-handle:active { cursor: grabbing; }

資料持久化整合


// 完整資料獲取 (包含節點位置 x/y)
function saveMindMap() {
  var data = jm.get_data('node_array'); // 或 'json'
  // data.data 中每個節點包含 x, y 座標
  localStorage.setItem('mindmap', JSON.stringify(data));
  // 或 AJAX 送至後端
  fetch('/api/mindmap', {
    method: 'POST',
    headers: {'Content-Type': 'application/json'},
    body: JSON.stringify(data)
  });
}

// 載入並還原位置
function loadMindMap() {
  var saved = localStorage.getItem('mindmap');
  if (saved) {
    var data = JSON.parse(saved);
    jm.show(data); // 自動還原節點位置
  }
}

常見問題排查

問題原因解決
節點無法拖拽未引入 jsmind.draggable.js 或 editable:false確認引入順序、設定 editable:true
拖拽後連線未更新SVG/Canvas 渲染未重繪呼叫 jm.resize() 或升級版本
觸控裝置拖拽衝突頁面滾動touch-action 未設定容器加 touch-action: none
拖拽位置不準確容器有 transform/縮放使用 getBoundingClientRect 計算相對座標
節點重疊無自動佈局避讓手動調整或啟用佈局引擎

替代方案比較

庫拖拽支援授權特色
jsMind✓ (模組化)BSD純 JS、輕量、主題豐富
markmap✗ (唯讀)MITMarkdown 渲染、靜態展示
SimpleMindMap✓MITCanvas 渲染、效能佳
MindMap (Vue/React)✓MIT框架整合、組件化
copyright © 萬盛學電腦網 all rights reserved