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 內部實現:
mousedown/touchstart 事件mousemove/touchmove 時即時更新節點 x/y 座標mouseup/touchend 確認位置,觸發 node_move 事件
// 監聽節點移動事件
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 | ✗ (唯讀) | MIT | Markdown 渲染、靜態展示 |
| SimpleMindMap | ✓ | MIT | Canvas 渲染、效能佳 |
| MindMap (Vue/React) | ✓ | MIT | 框架整合、組件化 |