WebTopo

特别说明-2025-10-11

该项目已经不再维护，且项目开发时间较早，这么多年已经有了很多更优秀的类似项目，请自行搜索选择

WEB组态

基于vue+quasar的web组态，核心代码基于vue，quasar仅仅是为了方便构建
github预览地址：https://phynos.github.io/WebTopo/dist/spa

更新日志

更新日志

后续重点TODO

• 完善撤销和恢复
• 折线箭头（思路：增加控制锚点作为转折点）
• 属性元数据设计和属性编辑UI生成（思路：仿造winform的属性面板）

功能清单

| 功能 | 状态 | | - | -: | | 面板标尺 | 完成 | | 拖曳添加组件 | 完成 | | 位置移动-鼠标 | 完成 | | 位置移动-方向键 | 完成 | | 位置移动-批量 | 完成 | | 拖动位置磁性吸附 | 未完成 | | 尺寸锚点（8个） | 完成 | | 旋转锚点 | 未完成 | | 选中效果 | 完成 | | 层叠控制 | 完成 | | 面板比例缩放 | 完成 | | CTRL+C/V复制黏贴 | 完成 | | CTRL+A多选 | 完成 | | 鼠标框选 | 完成 | | DELETE删除（支持删除多个） | 完成 | | 样式配置（文字、大小、位置、边框、颜色、旋转） | 完成 | | 组件继承体系 | 完成 | | DOM组件（文字、图片） | 完成 | | canvas组件（圆形、三角形、矩形、线条、箭头线条） | 完成 | | 折线箭头 | 部分完成 | | echarts组件 | 完成 | | SVG组件 | 完成 | | 组件同步/异步数据加载 | 完成 | | 通讯机制-事件总线 | 完成 | | 通讯机制-VUEX | 未开始 | | 事件总线-WebSocket | 未开始 | | 事件总线-MQTT | 未开始 | | VUEX-WebSocket | 未开始 | | VUEX-MQTT | 未开始 |

高级功能

| 功能 | 状态 | | - | -: | | 批量编辑属性 | 未完成 | | 对齐工具 | 未完成 | | 撤销和恢复 | 有限支持 | | 容器组件 | 未完成 | | 动画 | 未完成 |

撤销和恢复支持操作列表

| 命令码 | 操作 | 撤销 | 恢复 | | - | - | - | -: | | add | 新增 | 支持 | 支持| | del | 删除 | 支持 | 不支持| | move | 移动 | 支持 | 支持| | select | 选择 | 未完成 | 未完成| | -- | 反选 | 未完成 | 未完成| | resize | 形变 | 未完成 | 未完成| | copy-add | 多项复制 | 未完成 | 未完成| | -- | 属性修改 | 未完成 | 未完成|

存在问题

1. 目前的属性面板的鼠标编辑是硬编码的，这样初期拓展简单但是维护麻烦，更好的方法是每个属性定义完整的属性元数据，属性面板根据每个属性的元数据动态生成编辑，并支持属性分组

如何拓展控件

1. 定义数据文件（参见 \src\components\topo\data-toolbox下的json文件）
2. 新增控件，根据数据文件的数据自己实现显示方式（在\src\components\topo\control下新增控件，继承组件，可参考其他组件实现方式，整个思想就是利用第一步的数据绘制dom节点或canvas图像）
3. 注册控件到工具栏（在TopoToolbox.vue中）
4. 注册控件（在TopoBase.vue中）

其实整体思想很简单，就是定义一些数据，然后自己新增vue组件根据这些数据控制渲染和行为，其他的一些组态编辑操作是公共的。

组件和服务器通讯

3种机制：独立http、VUEX、事件总线（基于一个消息中心，订阅和发布消息的模式）

独立通讯-http

每个组件独立使用http接口和定时器实现，适用于少量组件的应用（组件太多会导致过多连接和定时器）

通讯机制-事件总线-演示

参见/src/assets/libs/simpleEventBus.js和ViewRect.vue组件的演示代码（直接进入预览可看见矩形变色）

通知机制-VUEX-演示

未开始

VUEX通讯-WebSocket

未开始

VUEX通讯-MQTT

未开始

事件总线-WebSocket

准备中

事件总线-MQTT

未开始

构建过程

• 安装NodeJs
• 安装vue-cli：npm install -g @vue/cli
• 安装quasar-cli：npm install -g @quasar/cli
• 进入根目录，执行安装npm install（建议使用cnpm安装）
• 启动项目：quasar dev

更多构建功能请参考quasar官网，以下是一些常用的构建命令

运行开发服务器

$ quasar dev

运行在特定端口

$ quasar dev -p 9090

PWA模式

$ quasar dev -m pwa

手机App

$ quasar dev -m cordova

Electron应用

$ quasar dev -m electron

注意：Electron应用等请参考官网配置相应的开发环境
安装yarn：npm install -g yarn
设置yarn镜像：yarn config set registry http://registry.npm.taobao.org/
安装electron：yarn add --dev electron@^7.0.0 electron-debug@^3.0.0 electron-devtools-installer@^2.2.4 devtron@^1.4.0
安装环境：cnpm install --global windows-build-tools

在打包过程中会从github下载文件，如果下载不了，可以直接百度网盘下载，网盘地址： https://pan.baidu.com/s/1RiHHBDJMeiXLubaFzryTAw

如何打包

1. 编辑quasar.conf.js下的publicPath，修改为实际的名称
2. 去编译后(使用命令quasar build)的dist文件夹将文件拷贝到web服务器即可
3. 目前publicPath默认为WebTopo，所以构建后访问http://127.0.0.1/WebTopo/即可
   注意：由于VUE使用history模式，使用nginx等服务器需要解决路径404问题（本项目只有2个url）

构建命令参考

build for production

quasar build

Electron App

quasar build -m electron

运行截图