如何快速装好 vue-webtopo-svgeditor SVG 组态编辑器:从克隆到自定义图形的完整指南
【免费下载链接】vue-webtopo-svgeditor基于vue3实现的svg可视化web组态编辑器。可无需修改代码动态添加svg组件项目地址: https://gitcode.com/gh_mirrors/vu/vue-webtopo-svgeditor
vue-webtopo-svgeditor 是一个基于 Vue 3 实现的 Web 端 SVG 可视化组态编辑器,专门用来在浏览器里搭建网络拓扑图、流程图和监控类组态页面。它的核心卖点是:把 SVG 文件(一种矢量图形格式)直接拖进画布就能变成可编辑的组件,添加新图形时无需改动任何业务代码。这篇安装教程带你走完整条链路:把项目跑起来,再把画布上的图形库扩展成符合你自己业务的样式。
几分钟内把编辑器跑起来 🚀
动手前先确认环境:本机装有 Node.js 12.x 或更高版本,并且装好了 npm 或 yarn 其中之一。满足后按顺序执行下面五步即可。
- 把代码拉到本地:
git clone https://gitcode.com/gh_mirrors/vu/vue-webtopo-svgeditor一条命令拿到项目全部源码。
- 进入项目目录:
cd vue-webtopo-svgeditor后续所有命令都在这里执行。
- 安装项目依赖:
npm install如果你习惯用 yarn,把上面换成yarn install也可以。
- 启动开发服务器:
npm run serve对应 yarn 的写法是yarn serve,两者效果相同。
- 浏览器打开
http://localhost:8080,能看到编辑器的完整界面就说明启动成功了。
把画布改成你的样子 🎨
编辑器的行为配置都收在src/config-center目录里,想扩展图形库,改动也集中在这里。往画布里加一个自己的 SVG 组件,需要完成三件事:
- 把下载好的 SVG 文件放进
src/assets/svgs目录; - 打开这个 SVG 文件,把你想动态修改的属性从代码片段里删掉。例如想动态控制填充颜色,就要删掉文件里的
fill属性; - 在
src/config-center下补一份对应的配置文件,把这个图形登记进编辑器。
配置中心源码里现成的例子可以直接照抄结构,照着改比从零写快得多。配置详解其实很简单:文件放对位置、删掉写死的属性、补上配置,组件就会出现在左侧图形库中。
上手只需要三个动作 ✍️
动作一:拖拽绘制
在左侧组件库中选中一个图形,按住鼠标左键不放,把它移动到画布中的目标位置再松开,组件就落位了。
动作二:操作节点
点选画布上已放置的节点,节点四周会冒出一圈锚点。借助锚点可以完成移动、缩放、旋转这三类基础操作,不需要切换工具。
动作三:绘制连线
光标移到组件上方时,会浮现出连线锚点。左键点一下锚点生成第一段线段,继续在画布上左键点击即可逐段延长,右键点击结束本次连线。
卡住了?看这里
依赖装上了,服务却起不来?换成
pnpm来安装依赖再试,这是目前验证最稳的方式。为什么每次改代码,eslint 都在报错?在 VSCode 里装一个 eslint 插件,保存时的问题就能被即时检查出来。
为什么要动下载来的 SVG 文件?删掉你想动态修改的属性之后,编辑器才能接管它。比如保留写死的
fill,颜色就改不动了。
如果照着一遍走完还是不通,建议带着报错信息到项目的 issue 区提一个问题,通常会有踩过同样坑的人回复你。
【免费下载链接】vue-webtopo-svgeditor基于vue3实现的svg可视化web组态编辑器。可无需修改代码动态添加svg组件项目地址: https://gitcode.com/gh_mirrors/vu/vue-webtopo-svgeditor
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考