网站访问速度优化工具河北建设执业信息网官网

平台：designable设计器
github：designable

1 背景

由于业务需求，我们需要实现designable平台的一个简易版的组件拖拽功能。

功能列表：

• 拖拽区域
  • 渲染组件列表，包括组件的名称和icon
  • 组件可以拖动
• 放置区域
  • 拖动后的组件可以放置，并且放置区域的组件依旧存在
  • 放置区域的组件可以正确渲染相应样式，使用formily的schema json渲染
  • 放置区域的组件可以上下移动排序，同时可以进行删除和编辑操作

2 技术栈

antd
formily：表单引擎，可以根据schema json直接渲染表单
react-beautiful-dnd：常用于列表的拖拽，支持排序
react-dnd：拖拽和放置功能，比如上面截图的组件拖拽

3 组件拖拽和放置

3.1 类型定义

右侧组件类型：id唯一标识，scheme存放渲染表单的json文件

export interface ComponentConfig {id?: string; // 唯一标识，随机生成，且不可更改key: string; // 表单字段key，用户可以更改title: string; // 拖拽区域的文案，不可更改component_type: ComponentType; // RN侧的组件标识，不可更改schema: ISchema;
}export enum ComponentType {TextInputRow = 'TextInputRow', // 文本输入框DateInputRow = 'DateInputRow', // 时间选择器CheckBox = 'CheckBox',
}

右侧组件列表：

export const ComponentConfigs: ComponentConfig[] = [{key: ComponentType.TextInputRow,schema: {title: ComponentType.TextInputRow,type: 'string','x-component': 'Input','x-decorator': 'FormItem','x-rn-component': ComponentType.TextInputRow, // RN侧的组件名称，必须要保持一致},},{key: ComponentType.DateInputRow,schema: {title: ComponentType.DateInputRow,type: 'string','x-component': 'DatePicker','x-decorator': 'FormItem','x-rn-component': ComponentType.DateInputRow,},},{key: ComponentType.CheckBox,schema: {title: ComponentType.CheckBox,type: 'string','x-component': 'Checkbox','x-decorator': 'FormItem','x-rn-component': ComponentType.CheckBox,},},
].map((i) => ({ ...i, title: i.key, component_type: i.key }));

3.2 拖拽

useDrag：让DOM实现拖拽能力的构子

• 请求参数：
  • type: 指定元素的类型，只有 类型相同的元素 才能进行drop操作
  • item: 元素在拖拽过程中，描述该对象的数据。可以在useDrop中的drop接收到该数据
  • collect: 返回一个描述状态的普通对象，然后返回以注入到组件中。它接收两个参数，一个DragTargetMonitor实例和拖拽元素描述信息item
• 返回参数：
  • 第一个返回值：是一个对象 表示关联在拖拽过程中的变量，需要在传入useDrag的规范方法的collect属性中进行映射绑定, 比如：isDraging, canDrag等
  • 第二个返回值: 代表拖拽元素的ref
  • 第三个返回值: 代表拖拽元素拖拽后实际操作到的dom

// 用于包裹每一个可以拖拽的组件
export const WrapComponent = (props: DndComponentDndItem) => {const [, drag] = useDrag(() => ({type: ItemTypes.CARD,item: props.config,// collect中可以监控drag状态变更，并把状态暴露给组件collect: (monitor) => ({ isDragging: !!monitor.isDragging() }),}));return (<divstyle={{width: 100, // todo: 卡片无法居中cursor: 'move',height: 50,display: 'flex',justifyContent: 'center',alignItems: 'center',backgroundColor: 'white',borderRadius: 4,}}ref={drag} // dom元素实例>{props.children}</div>);
};

3.3 放置

useDrop：让拖拽物放置的构子

• 请求参数：
  • type: 指定元素的类型，只有 类型相同的元素 才能进行drop操作
  • item: 元素在拖拽过程中，描述该对象的数据。可以在useDrop中的drop接收到该数据
  • collect: 返回一个描述状态的普通对象，然后返回以注入到组件中。它接收两个参数，一个DragTargetMonitor实例和拖拽元素描述信息item
• 返回参数：
  • 第一个返回值：是一个对象 表示关联在拖拽过程中的变量，需要在传入useDrag的规范方法的collect属性中进行映射绑定, 比如：isDraging, canDrag等
  • 第二个返回值: 代表拖拽元素的ref
  • 第三个返回值: 代表拖拽元素拖拽后实际操作到的dom