前言
本项目旨在开发一个供运营、产品快速搭建商城的可视化平台,利用可视化的拖拽与属性配置完成商城构建和日常运营,而开发只进行平台的维护、业务组件的新增和迭代。避免高频的业务需求,提升我们的开发效率。
本项目提供的是可视化搭建平台模板,大家可根据公司实际需求进行修改,最终形成满足自己实际需求的可视化搭建平台。
接下来我将带大家深入的了解Mall-Cook可视化平台的原理与技术实现。Mall-Cook可视化平台预览如下:
)
github地址:传送门
预览地址:传送门
开发前规划
明确目标人群
在进行具体开发前,首先我们需要明确我们开发的平台是给谁用的?是面向运营还是面向研发?研发人员适合low-code(低代码平台),而非研发人员适合no-code(无代码平台)。
我觉得两者最大的区别是组件通讯,也就是大家经常会问的组件怎么交互?
我举个栗子
low-code我推荐大家了解下云凤蝶我认为现在最期待的中后台搭建平台,平台理论可接入任意组件库或NPM组件,强大的解析器解析组件为平台所用。通过状态外置进行组件通讯,简单理解每个页面有个自己vuex,可以自定义状态(变量)、方法,根据需要把状态、方法绑定组件,实现组件的交互,云凤蝶在知乎有几篇介绍的文章。云凤蝶yyds!
no-code首推政采云的鲁班,有赞与微盟虽然是独角兽级别的模板,但是它们太太太大了,我也找不到核心架构文章,无法深度了解。而鲁班手把手详细给我讲解了可视化搭建的内核,schema的作用与重要性,虽然体量与复杂度无法与有赞与微盟相比,但它是教会我的那个人。
选择画布布局方案
对于布局方案,我们只取决于两个点中的一个,自由或便捷,其他的大多是噱头。
自由布局适合与大屏与中后台系统,因为其页面自由度高,物料间可相互覆盖。
那为什么流式布局适合H5与小程序呢?
我举个栗子,比如H5页面中,你的商品列表是根据网络接口实时查询,当商品数量发生变化导致商品列表组件高度变化时,我们通过流式布局保证布局不受影响。
其他布局:举个反栗凡科技提供的是类自由布局,这是除我上述两种布局外,其他布局想实现的功能基本齐了,支持父子组件间的嵌套、自由拖拽、颗粒化基础物料(text、button)。看着功能都齐了,但我实际使用发现操作复杂不实用,且只能进行部分静态样式的自定义。同样是一个商品列表,我想通过拖拽自定义单项样式,或者我想给没他banner图片自定义添加文字,发现这种动态组件同样只能靠配置项设置。结论发现实用性并不高,反而搭建页面比单纯流式布局复杂数倍。
布局我只推荐流式布局和自由布局,其他的附加功能大多是噱头大于实际,具体附加功能根据实际场景决定是否添加。
比如组件嵌套功能,我在页面配置中未提供此功能,这不是不能实现,而是组件嵌套一般用类似在TAB栏的容器中,可在每个TAB中嵌套不同的组件,我觉得为了这个实现,而提供页面组件的无限嵌套的复杂逻辑不值得。而在Schema协议生成器中提供了Object、Array对象类型的组件嵌套,是因为数据结构是可以任意嵌套的,比如props接收一个对象数组类型的数据。是否需要某个功能根据实际实用场景而定,而不是我全都要,越多就觉得越厉害。对用户而言,操作越简单越友好,可以看有赞、微盟方案。对于流式布局钳制自由度的劣势,用大量业务组件、页面模板填充,目的就是让用户操作简单。
单纯流式布局看起或许很low,但是操作越是简单,用户才越是方便。我想做的是能实用的工具,而不是看起来有点炫的玩具。
确定可视化平台开发的核心
可视化平台开发的核心是什么?
是一个可拖拽的组件列表,一个展示组件画布,一个组件属性控制面板组成的控制中心?是一套看起功能眼花缭乱的布局方式?
不,是规范,一套规范。
每个成熟的可视化平台,都会经历长期的迭代升级,无数实用的业务组件会在其后大量的新增与迭代,一套标准的规范才能使平台健康成长直至成熟稳定。
那怎么要定义规范?定义规范有什么用?
我们说个最简单的,定义组件的规范。
一个标题组件接入平台,我不会关心你的内部实现,我只关心你的props入参,我怎么通过属性配置面板去控制你。
- 原始方式 写一个包含title字段输入框的表单的配置面板
- 进阶方式 为每个组件写一个JSON去描述组件的关键信息,给它配张身份卡供我们平台识别。
// 组件描述JSON
{
"label": "标题组件", // 组件名
"icon": "icon-title", // 组件图标
"fields": { // 组件属性
"title": { // 属性名
"label": "标题", // 属性label
"type": "string", // 属性类型
"value": "LEADING SERIES" // 属性初始值
}
}
}
一旦进入平台我们就通过解析JSON身份卡,获取组件信息。然后我们开发一个属性配置器,传入组件信息中的属性数据,通过属性配置器生成属性控制面板
进阶方式解耦、工业化,这样才能在后面使大量组件接入平台。然而有一个风险点JSON是无规则的,组件描述JSON应该按平台定的规则来写平台才能识别,所以我们需要用规则来标准化JSON。
解决办法就是通过JSON Schema协议来约束JSON,让它根据我们定的标准来编写。(后文有平台Schema协议具体讲解)
So,我们定义的Schema协议,是我们平台规范的工具,也就是我们可视化开发平台的核心。
平台介绍
Mall-Cook平台的目的是可视化构建移动商城,商城构建流程模仿有赞、微盟,平台提供:
- 可视化推拽面板,流式布局
- 多页面搭建
- 实时预览
- H5页面适配
- 自定义底部tab菜单
- 商品管理 (现为模拟商品,可修改接口管理真实商品)
- 商品分类管理,自定义商品分类页
- 模板商城
- Schema生成器,可视化生成属性控制面板
平台速览
项目结构
├─ h5 // h5项目
│ ├─ api
│ ├─ assets
│ ├─ components
│ ├─ pages
│ ├─ router
│ ├─ store
│ ├─ utils
│ ├─ App.vue
│ └─ main.js
├─ src // admin项目
│ ├─ api
│ ├─ assets
│ ├─ components
│ ├─ config // 初始配置文件
│ ├─ custom-components // 物料库
│ ├─ custom-schema-template // 属性组件库
│ ├─ custom-schema-template-set // 属性面板生成器
│ ├─ mixin
│ ├─ pages
│ ├─ router
│ ├─ scss
│ ├─ store
│ ├─ utils
│ ├─ App.vue
│ └─ main.js
├─ package.json
├─ ftpUp.js // ftp上传文件
└─ webpack.config.js
项目分为admin与h5两个项目包,package.json支持分别/共同打包、一键部署
{
"name": "mall-cook",
"version": "0.1.0",
"scripts": {
"dev": "cross-env GZIP=false TYPE=admin vue-cli-service serve", //admin 启动
"dev:h5": "cross-env GZIP=false TYPE=h5 vue-cli-service serve", // h5 启动
"build:admin": "cross-env GZIP=true TYPE=admin vue-cli-service build --no-clean --mode development --report", // admin打包
"build:h5": "cross-env GZIP=true TYPE=h5 vue-cli-service build --no-clean --mode development --report", //h5 打包
"build:dev": "npm run build:h5 && npm run build:admin --mode development", // admin&h5共同打包
"deploy": "npm run build:dev && node ftpUp.js" // ftp部署 - 请在ftpUp.js配置服务器信息
},
}
JSON Schema
基础类型
又到了举栗子的环节
这是一个基础的属性Form表单,包括输入框、单选器、计数器,它们由各种元素组成。接下来我们用JSON来代表元素来组装它们:
复合类型
我们除了基础类型外,组件经常也需要传入对象、数组、对象数组等复合类型。我们应该支持任何的复合类型。我们来看导航栏数据列表:
业务场景实例
从上面我们知道了怎么用JSON表示基础类型和复合类型数据,而一个组件props能接收任意数量任意类型的数据。接下来我们用导航栏组件来实际分析:
导航栏组件接收styles(对象)、attrs(对象)、tabList(对象数组)
props: {
styles: {
type: Object,
default: () => {}
},
attrs: {
type: Object,
default: () => {}
},
tabList: {
type: Array,
default: () => []
}
},
下面我们来一一细看:
[图片上传失败...(image-a4b4c-1639209288830)]
[图片上传失败...(image-d5e26b-1639209288830)]
[图片上传失败...(image-6ac297-1639209288830)]
然后我们把各个接收数据合并在一起,再加上组件的基础信息,就构成了一个描述组件的JSON。
我们按照平台JSON Schema协议写的标准JSON可以让平台识别组件信息,再调用属性解析器生成属性控制面板来控制组件。
Schema 生成器
Json Schema 应该要满足两点:
- 定义JSON规则,约束JSON
- 检验机制,可检测当前JSON是否满足Json Schema规则
我们虽然定义了Json Schema,不过我们还没有相对应的检验机制。我怎么知道我写的JSON是否正确?这时我们应该继续开发个校验器,校验JSON。不过我选择了一种更高效的方法,开发Schema 生成器,用工具来规则代码,同时避免繁杂json的编写
Schema 生成器功能:
- 所见即所得,可视化拖拽实际的属性面板
- 支持对象组件(object、array)嵌套,构成复合类型
- 自动生成全部JSON,无需用户修改,直接引用
- 支持JSON引入功能,可把生成JSON引入,以供重复修改
结尾
Mall-Cook只是一个以构建H5商城场景的项目模板,大家可以根据实际场景(比如酒5、外卖等)克隆项目修改逻辑。此项目的核心是实现从Schema生成到构建一套完整可视化项目的标准,抛砖引玉的让大家了解Schema对可视化平台的重要性。
未来平台计划
- 平台迭代
后续会陆续加入更多的通用物料组件和商城的逻辑的完善
- 支持小程序
后面计划把H5项目由uni-app替换,物料也移入uni-app中。利用uni-app一码开发多端部署特点,实现支持H5、小程序等多端。
- npm组件注册
未来会试试实现npm组件在平台的注册与加载,最麻烦的应该是npm组件的版本管理,这个很有挑战性。(导入的自定义组件需提供components.json的组件描述json来识别组件)
未来可视化计划
未来的话,我的计划:
MALL-COOK 迭代
- 开发提供小程序版(uni-app)
-
- 开发小程序配置商城,Mall-Cook配置json传入项目生成小程序
-
- 开发物料库(uni-app版),可在现有小程序中引入物料库,传入Mall-Cook配置Json,自定义构建单页面
-
- 迭代提供大量业务组件
开发中后台可视化代码生成器
我原本计划开发一个低配版云凤蝶(可视化低代码平台)。可是仔细考虑,这种项目除非业务固定或者像云凤蝶开发完整度足够高,满足大量自定义需求,否则实用性较低。
所以计划开发代码生成器,生成器80%-90%基础、重复功能,剩下自定义功能代码开发,提高中后台开发效率。功能计划如下:
平台与element组件库绑定
-
提供生成器配置功能包(只是基础封装,达到减少生成代码作用,切记避免深度封装,导致使用学习成本高,反而本末倒置)
- 单页面mixin,提供公共数据方法定义,减少生成代码
- 提供Pagination(分页)、dialog、table、select、DatePicker等组件封装,配套使用(是在element基础上封装,更方便使用,并减少生成代码)
- 插拔式校验库,配套使用(同样提供方便,减少生成代码)
开发类似yapi(低配版),api管理功能,并根据分页接口数据模型,解析生成标准Json Schema
根据Json Schema生成CURD可视化表单(省去一般form generator,单个拖拽然后配置key的人工流程)
根据实际情况修改CURD表单每个单项
调整完成,生成vue代码
开发目的
开发MALL-COOK包括后面的中后台可视化代码生成器,是想通过构建小成本平台提高基础开发的效率。(项目自己一人开发,精力有限,想通过较小开发成本进行基建,可看早早聊堂主基建分享)
MALL-COOK开源的同时我也会在自己公司推出去,然后根据实际需求修改一下,即可上架给公司使用。同理大家也可根据自己的实际需求fork项目修改,然后使用。MALL-COOK的核心是从schema生成到项目生成的一套流程。至于具体业务大家可以自己DIY。
至于开发的原因?
基建不比天天写CURD、写H5有意思?