实际开发中,模态框展现数据会经常出现.但不幸的是有时功能开发完了,UI同学突然提出需求希望模态框能拖拽.本文使用的模态框由 ant design 3.0 的 Modal 组件封装而成,如何在不修改原来代码的基础上实现拖拽呢.最终效果图如下:
1.创建高阶组件DragHoc
新建文件ModalDrag/index.js,将下面代码copy进去
DragObj是具体拖拽的原生js代码,后面再看
DragHoc是创建高阶组件的函数,其中参数InnerComponent是需要被改造的模态框组件,函数最终的返回值是增强后的组件
render方法中直接返回了 <InnerComponent/> ,并没有返回一个新组件.整个高阶组件的作用只是在输入组件上加了一个ref属性.有了ref,init方法中可以通过 ReactDOM.findDOMNode 获取到传入的任意组件的原生dom.拿到dom以后就可以做底层的dom操作或事件绑定以实现拖拽
init方法里加了一个延时0s的定时器,由于笔者的项目中InnerComponent是用ant design里面的Modal封装而成.在调试的过程中发现,ReactDOM.findDOMNode 只能返回已经挂载到页面上的dom元素,否则返回null.而ant design里面的Modal渲染内容是异步的,因此要使用定时器等到下一帧才能使用findDOMNode得到组件的dom元素.如果InnerComponent里面不包含异步渲染的代码,下面的定时器可以删除
组件卸载时调用destory方法将所有绑定的事件释放掉
拖拽一个元素通常需要传入两个参数.一个是推拽后能移动的区域,对应着上图中的整个导出表格控件,控件的类名为main_class.另外一个是监听拖拽的区域,对应着上图中的头部,只有当鼠标在头部按下时再移动才能拖动表格.头部的类名为title_class.两个参数都从外部传入.如果两个参数都不传,默认直接监听child_node并拖拽child_node
import React from 'react';
import ReactDOM from 'react-dom';
import DragObj from './drag';
//main_class和title_class都是类名
export const DragHoc = (InnerComponent,main_class,title_class) =>
class extends React.Component {
componentDidMount() {
this.init();
}
init = () => {
setTimeout(() => {
const child_node = ReactDOM.findDOMNode(this.refs.child); //获取到原生的dom元素
if (child_node) {
this.drag_obj = new DragObj(
main_class?child_node.querySelector(`.${main_class}`):child_node, //只拖拽类名为 ${main_class} 的div
title_class?child_node.querySelector(`.${title_class}`):child_node //当鼠标按在类名为 ${title_class} 的div上时才允许拖拽
);
}
}, 0);
};
componentWillUnmount() {
if (this.drag_obj) {
this.drag_obj.destory();
}
}
render() {
return <InnerComponent {...this.props} ref="child" />;
}
};
如果在实践中发现拖拽无效,请务必将上面代码中的child_node打印出来,观察是否获取到了真实的dom以及它内部是否渲染完整.如果没有渲染完全,说明InnerComponent包含异步渲染的代码,要等到渲染完毕后再进行拖拽事件绑定
2.创建拖拽类DragObj
新建文件ModalDrag/drag.js,将下面代码copy进去
下面是实现拖拽的原生代码.主要负责对dom元素进行事件绑定以及改变位置等
export default class DragObj {
start_x0 = 0;
start_y0 = 0;
start_x1 = 0;
start_y1 = 0;
state = false; //记录鼠标按键是否松开
delta_x = 0; //相对于原始位置的横向偏移量
delta_y = 0; //相对于原始位置的纵向偏移量
constructor(target, move_item) {
this.target = target; //被移动的dom元素
this.move_item = move_item; //接受触发移动行为的dom元素,一般为模态框的头部
this.init();
}
init() {
this.move_item.style.cursor = 'move';
this.bindEvent();
}
destory() {
this.move_item.removeEventListener('mousedown', this.moveStartFun);
document.removeEventListener('mousemove', this.movingFun);
document.removeEventListener('mouseup', this.moveEndFun);
}
bindEvent() {
this.moveStartFun = this.moveStart.bind(this);
this.movingFun = this.moving.bind(this);
this.moveEndFun = this.moveEnd.bind(this);
this.move_item.addEventListener('mousedown', this.moveStartFun);
document.addEventListener('mousemove', this.movingFun);
document.addEventListener('mouseup', this.moveEndFun);
}
moveStart(e) {
e.stopPropagation();
this.state = true; //检测鼠标是否处于按下的状态
this.start_x0 = e.pageX;
this.start_y0 = e.pageY;
}
moving(e) {
//鼠标移动时的默认操作
e.stopPropagation();
e.preventDefault();
if (!this.state) {
return false;
}
this.start_x1 = e.pageX;
this.start_y1 = e.pageY;
this.render();
}
moveEnd(e) {
if (!this.state) {
return false;
}
this.state = false;
this.delta_x = this.start_x1 - this.start_x0 + this.delta_x;
this.delta_y = this.start_y1 - this.start_y0 + this.delta_y;
}
render() {
this.target.style.transform = `translate(${
this.start_x1 - this.start_x0 + this.delta_x
}px,${this.start_y1 - this.start_y0 + this.delta_y}px)`;
}
}
3.外部调用
引入高阶函数DragHoc,引入需要增强的模态框组件ToastExport
由于笔者在项目中使用 ant design 3.0 中的 Modal 组件做模态框,让其拖拽只需要传递类名 “ant-modal-content” 和 “ant-modal-header”.
其他场景需要根据静态模态框组件的dom结构分析哪一部分是要移动的,哪一部分是监听拖拽的,将这两部分的类名作为参数传入
import { DragHoc } from "./index.js";
import ToastExport from "../components/ToastExport/index.js";
//引入静态的模态框组件(用户自已定义的模态框组件)
const ToastExportv2 = DragHoc(ToastExport,"ant-modal-content","ant-modal-header");
//生成了具备拖拽功能的模态框组件
调用DragHoc函数生成ToastExportv2后,接下来就可以页面上直接使用.如果业务上需要传递参数直接加在属性上
const { visible } = this.props; //visible控制显示隐藏模态框
{visible?<ToastExportv2 visible={visible}/>:null}
调用时需要注意,当visible为true时再渲染ToastExportv2,为了防止绑定事件时dom还没开始渲染.visible为false时,组件销毁会自动调用destory方法解绑已注册的事件