也在 H5-Dooring 项目中做了很多技术实现, 包括:
搭建平台的组件设计和分类模式
拖拽生成页面方案
动态表单编辑器设计
页面实时预览编译技术
自定义组件和自定义模版方案
多人协作的可视化搭建模式实现
还有很多技术细节这里不一一举例了, 最近在研究自由布局时发现有这样一个需求, 我们可以自由拖拽和缩放组件, 并能从组件的不同纬度拖拽, 如下图所示:
由于我们的技术栈采用的是 React, 目前还没有一个成熟库可以同时支持自由拖拽和缩放, 我们不得不用 react-dragable 和 react-resiable两个库来实现拖拽和缩放, 但是这样我们要维护的数据结构就相当复杂了(当然vue生态有成熟的vue-dragable等来支持自由拖拽和缩放), 所以最后笔者决定自己来实现一个.
我们从可视化搭建平台的实际业务出发, 可以分析出拖拽缩放有如下几个功能点:
自由拖拽
支持控制点, 多方位缩放
支持自由控制层级
支持组件静态化(即为了实现固定, 预览页面等效果)
拖拽缩放的数据能回传给上层组件并提供受控机制
实现以上四点我们就可以实现一个可用的拖拽缩放组件. 接下来笔者就来介绍一下实现的开源拖拽缩放组件rc-drag.
实现自由拖拽
rc-drag未压缩的体积只有20多k, 去除注释核心代码不到200行, 可以说是一个非常轻量的拖拽缩放组件库了, 我们要想让自己的组件能自由拖拽, 只需要使用如下方式:
1.安装
- npm i @alex_xu/rc-drag # 或
- yarn add @alex_xu/rc-drag
2.基本使用
- "box" style={{position: 'relative', width: '500px', height: '260px'}}>
-
Mr xu
我们只需要以上几行代码就能实现组件的自由拖拽. 效果如下:
解决可视化搭建平台页面层级的问题
目前在 h5-dooring 是通过横向扩展来解决组件层级和嵌套的问题, 如果我们采用自由拖拽布局, 层级和嵌套的问题就很好解决了. 在 @alex_xu/rc-drag 这个库中笔者实现设置层级的功能, 所以我们可以通过给拖拽组件设置不同的层级, 来实现页面元素叠加和层的概念. 如下设置:
-
Mr xu
-
我们通过给组件设置更高的层级来实现组件堆叠的效果.
实现组件静态化
我们往往会在编辑页面时对组件进行拖拽等操作, 但是有些场景我们需要让组件固定, 比如头部或者页脚, 或者锁定某个元素, 类似于 PS 里图层锁定. 另一个场景是我们要实现公共的页面渲染器, 在编辑状态下可以自由拖动缩放, 但是在预览状态下需要让元素固定, 不能出现自有拖拽等功能, 类似 h5-dooring 那种模式, 这个时候我们需要让拖拽组件@alex_xu/rc-drag支持静态化. 这个时候我们可以设置isStatic属性为true, 如下图:
代码如下:
static item
我们可以利用这个属性, 写个页面渲染器, 用户在预览时将组件的isStatic设置为true即可, 源码的底层实现其实也很简单, 就是利用react-hoooks的组件编写方式写个判断即可:
- { isStatic ?
- "x-drag-item" style={style}>{ children } :
- className="x-drag-item"
- style={style} onMouseDown={(e) => onMouseDown('move', e)}
- onMouseUp={onMouseUp} onMouseMove={onMouseMove} >
- }
实现组件数据上报
我们都知道组件单纯只有拖拽缩放能力远远不能满足业务需求, 对于可视化拖拽组件, 更重要的是要能保留拖拽后的数据, 比如宽高,位置,层级等数据, 所以我们需要监控几个事件, 并将数据传给对应的事件来让外层能监听和获取. 这里笔者提供了两个拖拽回传方法:
onDrapStart
onDrapStop
后面根据实际情况可以对应添加. 我们可以在父组件中绑定对应的方法, 如下:
- size={[200, 200]} zIndex={2}
- onDragStart={(item) => console.log('start', item)} onDragStop={(item) => console.log('stop', item)}
- >
Mr xu
-
这样我们就能在父层拿到对应的数据并保存下来了, 进而也就能实现我们的预览页面的功能了. 具体可以参考H5-Dooring 渲染器的部分.
支持移动端拖拽
目前笔者已经支持移动端使用@alex_xu/rc-drag组件了,我们如果要做移动端的H5编辑器, 可以直接使用它来实现拖拽功能.
以上几个技术点和技术实现是可视化拖拽组件必备的要素, 大家可以使用参考一下.
