2023-06-26 10:32:36 +08:00

4.5 KiB

Raw Blame History

开始

安装

npm i simple-mind-map

0.2.0版本之前的注意事项：

注意：本项目为源码直接发布，并未进行打包，如果出现编译失败的情况，Vue CLI创建的项目可以在vue.config.js文件中增加如下配置来让babel-loader编译本依赖：
module.exports = {
     transpileDependencies: ['simple-mind-map']
}
其他项目请自行修改打包配置。

使用

本仓库的web目录提供了一个基于Vue2的完整项目，如果你遇到了一些使用上的疑惑，可以参考该项目的实现。

想要了解在其他框架中的使用，你可以参考以下这些非官方的实现：

1.https://github.com/huangyuanyin/hyy-vue3-mindMap：一个基于 Vue3.2 +ElementPlus的思维导图。

首先提供一个宽高不为0的容器元素：

<div id="mindMapContainer"></div>

另外再设置一下css样式：

#mindMapContainer * {
  margin: 0;
  padding: 0;
}

然后引入simple-mind-map库，创建一个实例：

import MindMap from "simple-mind-map";

const mindMap = new MindMap({
  el: document.getElementById('mindMapContainer'),
  data: {
    "data": {
        "text": "根节点"
    },
    "children": []
  }
});

这样即可得一个思维导图。

如果你想要实现一个完整思维导图，那么通常你需要开发一些ui界面，通过simple-mind-map库提供的接口来实现更多功能。

simple-mind-map支持丰富的配置、事件、命令，以及一些额外的插件扩展，阅读后续的文档来了解更多吧。

默认引入的是未打包的ES模块，且只包含核心功能，不包含未注册的插件内容，能有效减小体积，不过你需要在你的项目中配置babel编译simple-mind-map，防止一些较新的js语法部分浏览器不支持。

如果你需要umd模块格式的文件，比如以CDN的方式在浏览器上使用，那么你可以从/simple-mind-map/dist/目录中找到simpleMindMap.umd.min.js文件和simpleMindMap.css文件，复制到你的项目中，然后在页面中引入：

<link rel="stylesheet" href="simpleMindMap.css">
<script scr="simpleMindMap.umd.min.js"></script>

会创建一个全局变量window.simpleMindMap，可以通过window.simpleMindMap.default获取到MindMap构造函数，详细信息可以把window.simpleMindMap打印出来看一下。

这种方式的缺点是会包含所有的内容，包括你没有注册的插件，所以整体体积会比较大。

（v0.5.4+）如果你想直接在浏览器端通过ES模块的方式来使用，你可以在/simple-mind-map/dist/目录中找到simpleMindMap.esm.js和simpleMindMap.esm.css文件。

开发

如果你只是使用库的话可以不用阅读此小节。

本地开发

git clone https://github.com/wanglin2/mind-map.git
cd mind-map
cd simple-mind-map
npm i
npm link
cd ..
cd web
npm i
npm link simple-mind-map
npm run serve

打包库

自0.2.0版本开始增加了对核心库simple-mind-map的打包，复用了示例项目web的打包工具。

cd web
npm run buildLibrary

simple-mind-map库的package.json文件提供了两个导出字段：

{
  "module": "index.js",
  "main": "./dist/simpleMindMap.umd.min.js",
}

支持module字段的环境会以index.js为入口，否则会以打包后的simpleMindMap.umd.min.js为入口。

编译文档

cd web 
npm run buildDoc

打包demo

cd web
npm run build

会自动把index.html移动到根目录。

问题

1.在Vite中使用报错，提示xml-js依赖出错

解决方法：使用如下引入方式：

import MindMap from "simple-mind-map/dist/simpleMindMap.umd.min"

simple-mind-map包提供未打包的入口字段module，依赖的xml-js包需要引入node环境下的包，所以在Vite中获取不到会报错，所以指定引入打包后的入口，相关包都已打包进产物，所以不会报错。

如果需要二次开发，也就是必须要使用未打包代码的话，如果你不需要解析xmind文件的话，可以去除xmind模块，如果需要的话那么可以尝试换成其他的解析xml为json的库。

2.报错`Getting bbox of element "text" is not possible: TypeError: Cannot read properties of undefined (reading 'apply')`

原因为安装的@svgdotjs/svg.js版本太高，手动降到3.0.16版本即可。

4.5 KiB Raw Blame History Unescape Escape

开始

安装

使用

开发