前言
实际开发中,模态框展现数据会经常出现.但不幸的是有时功能开发完了,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方法解绑已注册的事件
以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持。