基于 vue3.2+ts 实现的 svg 可视化 web 组态编辑器。可直接把 svg 文件和 vue 组件作为编辑器图形库使用,赋予其缩放和旋转等功能,并支持自定义拓展参数,实时控制组件状态等
qq
交流群:209048413
,仅供交流,有问题请提issue,以便帮助更多有相同问题的人
历史版本请在本项目其它分支进行查看
没有特殊需求,只需要配置好图形库,即可开始您的组态世界
使用了svg
的symbol
技术,use
方式加载svg
图形,同样的 svg 图形不管数量多少,只会渲染一次
svg
文件即组件,引入之后无需进行额外配置,编辑器会自适应解析加载组件,添加自定义组件和传统html
无差,前端 er 零学习成本上手
配置文件采用开放式结构,属性支持自定义拓展。图形库支持添加svg
文件或者vue
组件,定制开发将变得容易
项目已经编写好了库模式脚本,组件已经发布到npm,支持外部传入自定义组件,支持组件事件订阅等
MIT 开源协议 可商用(自带的svg
文件除外)
无状态组件就是svg
文件,编辑器已经将节点的拖动,缩放,旋转等功能封装好了,您无需做出额外配置即可使用,若是需要动态的去设置svg
的颜色边框之类的,需要自行设置props
,参考src\config-center\svg-file\stateless
的配置,可以设置的属性为svg
的公共属性,例如fill
、stroke
、stroke-dasharray
这些,具体属性请参考MDN-SVG 属性
有状态组件也是 svg 文件,区别就在于无状态组件控制节点属性的配置配置在props
上,而有状态组件的配置需要配置到state
上,有状态组件对比无状态组件的好处是可以改变一个状态去影响多个属性,例如这里的断路器开关,其实是同时改变了颜色和把手的透明度,参考配置:src\config-center\svg-file\stateful\circuit-breaker\index.ts
没什么好说的了,支持直接使用自带动画的svg
文件,参考src\config-center\svg-file\have-animation
本质上就是vue
的template
代码片段,它可以完全替代无状态组件和有状态组件,并且可以根据自定义代码实现更多节点和属性的控制,缺点就是需要写代码--!参考src\config-center\svg-file\custom-svg
其实和自定义svg
相似,都是vue
的template
代码片段,但是svg
标签里面无法渲染html
的代码,所以在最外层用了foreignObject
进行了包裹,同样支持缩放旋转等操作。参考src\config-center\vue
选中左侧的组件库,按住鼠标左键即可把组件拖动到画布中
选中绘制好的节点后会出现锚点,可以直接进行移动、缩放、旋转等功能,右侧属性面板可以设置配置好的节点的属性,鼠标右键可以进行一些快捷操作
鼠标移动到组件上时会出现连线锚点,左键点击锚点创建线段,继续左键点击画布会连续创建线段,右键停止创建线段,鼠标放在线段上会出现线段端点提示,拖动即可重新设置连线,选中线段后还可以在右侧的动画面板设置线段的动画效果
- 若是组件中心点不是鼠标指针点,请自行在页面设置里匹配
x
轴和y
轴数据 - 组件隐藏后,可以在顶部工具栏的组件树里面选中隐藏的组件,进而设置隐藏组件的属性
- 本项目示例
svg
文件规格以标准图标大小1024x1024px
,如果您的组件效果不好,请使用该规格
# 创建项目(已有项目跳过此步骤)
npm init vite@latest
# 进入项目目录
cd projectname
# 安装插件
pnpm i webtopo-svg-edit
# 安装pinia
pnpm i pinia
# 修改main.ts 注册pinia
import { createPinia } from 'pinia';
const app = createApp(App);
app.use(createPinia());
app.mount('#app')
#在需要的页面引入插件
import { WebtopoSvgEdit,WebtopoSvgPreview } from 'webtopo-svg-edit';
import 'webtopo-svg-edit/dist/style.css'
如果集成有问题请参考示例项目vue-webtopo-svgeditor-example
请注意:插件方式引入会导致左侧工具栏的 icon 图标无法正确显示,请自行寻找您项目构建工具的 svg 加载器,将 icon 图标转换成 symbol,并将名字命名为‘svg-xxx’即可正常显示
Fork
本项目- 新建
Feat_xxx
分支 - 提交代码
- 新建
Pull Request
只接受 github 的 pr,gitee 为 github 镜像库
本项目组件库来源均为网络,仅供学习交流使用,请勿将本项目里面的组件用于商业用途
开源版使用时请保留底部的版权声明,感谢支持
vue2建议使用iframe集成,目前没有vue2的版本,如果您接受不了vue2方式集成,也可参考2.1分支进行改造。
吉林省格尺科技有限公司促进该项目诞生
秀英童鞋对此项目前进的耐心指导
如果这个项目对您有所帮助,请扫下方二维码打赏一杯咖啡。