React 实现 Modal 思路简述

最新推荐文章于 2026-07-16 08:05:54 发布

原创最新推荐文章于 2026-07-16 08:05:54 发布 · 3.9k 阅读

1 ·

本内容遵循CC 4.0 BY-SA版权协议

收录于

前端架构

React

Antd

本文探讨了模态对话框（Modal）的自实现过程，包括其在保持工作流程连贯性时的作用，以及如何使用AntdModal文档接口实现核心功能。文章详细介绍了Modal组件的两种用法：常规组件用法和静态方法调用，并提供了内部实现细节。

Modal 简述

模态对话框。需要用户处理事务，又不希望跳转页面以致打断工作流程时，可以使用 Modal 在当前页面正中打开一个浮层，承载相应的操作。

另外当需要一个简洁的确认框询问用户时，可以使用 Modal.confirm() 等语法糖方法。

核心功能点提取

根据 Antd Modal 文档提供的接口来实现 Modal.

在这里插入图片描述

核心实现

Modal 组件的特殊在于它有两种用法:

通常用法：<Modal visible={this.state.visible} {...props}></Modal>
调用静态方法： Modal.confirm({ title: '取消后，已编辑的脚本信息将不会保存，请确认是否取消。', okText: '确认取消', cancelText: '暂不取消', onOk() { me.props.onCancel(); } })

我的想法是这两种调用都在 internalModal.tsx 中统一维护

在这里插入图片描述
顺着这个思路，对于 Modal.tsx 。
1）不会维护 render 方法，而是在 componentDidMount / componentDidUpdate 生命周期中调用 internalModal.tsx 完成渲染
2）Modal.tsx 中维护相关静态方法 confirm, error, info 等。

// Modal.tsx
export default class Modal extends React.Component<ModalProps, {}> {
    static propTypes = {
		...
    };

    static confirm(content) {
        const modal = new InternalModal();
        const props = {
            ...Modal.defaultProps,
            title: '提示',
            children: content,
            cancelButton: true,
            okButton: true,
            okButtonText: '确定',
            cancelButtonText: '取消',
            closable: false,
            visible: true,
            onOk() {
                modal.destroy();
            },
            onCancel() {
                modal.destroy();
            }
        };
        modal.render(props);
    }

    private modal;
    constructor(props: ModalProps) {
        super(props);
        this.modal = new InternalModal();
    }

    componentWillUnmount() {
        this.modal.destory();
        this.modal = null;
    }

    componentDidMount() {
        this.modal.render(this.props);
    }

    componentDidUpdate() {
        this.modal.render(this.props);
    }

    componentWillReceiveProps(nextProps) {
        if (nextProps.visible) {
            this.modal.show();
        } else {
            this.modal.hide();
        }
    }

    render() {
        return null;
    }
}

接下来就是最关键的 internalModal.tsx :

export default class InternalModal {

    private props;

    render(props) {
        const {...} = this.props;

        this.createContainer();
        const icon = require('../../assets/icon/info.svg') as string;

        const modalDOM = ...;

        ReactDOM.render({modalDOM}, modalContainer,
	        () => {
	            if (visible) {
	                this.show();
	            }
	        });
    }

	...

    createContainer() {
        if (!modalContainer) {
            modalContainer = document.createElement('div');
            document.body.appendChild(modalContainer);
        }
    }

    destroy() {
        if (modalContainer) {
            ReactDOM.unmountComponentAtNode(modalContainer);
        }
    }

    show() {
        if (modalContainer) {
            modalContainer.style.display = 'block';
        }
    }

    hide() {
        if (modalContainer) {
            modalContainer.style.display = 'none';
        }
    }
}

从代码可以发现 internalModal 的实现要点：

作为一个普通 js 类 (并没有继承 React.Component) ，提供一个 render 方法，render 中通过 ReactDOM.render(element, container[, callback]) 渲染弹出窗口
在 document 上创建一个 div container 乘放 Modal，通过 css display 控制显示/隐藏，其实也可以使用 React Portal.
可以用一些第三方库比如react-transition-group 来增强 Modal 显示/隐藏的动画效果。