React项目中hook实现展示对话框功能

2024-04-02 19:04:59 244人浏览薄情痞子

摘要

目录思路：使用全局状态管理所有对话框尝试设计一个api去做对话框的全局管理实现：创建NiceModal组件和相关API处理对话框的返回值总结React中使用对话框并不容易，主要因为：

对话框需要在父组件中声明，才能在子组件中控制其是否显示
给对话框传递参数只能由props传入，这意味着所有状态管理都必须在更高阶的组件中。而实际上这个对话框的参数只在子组件中才会维护。这时就需要我们使用自定义事件将参数传回

这些问题的本质就是：如何用一个统一的方式去管理对话框，从而让对话框相关的业务逻辑更加模块化，以及和其他业务逻辑进行解耦。

下面的方式只是经验总结，并不是唯一或者最佳实现：

思路：使用全局状态管理所有对话框

对话框本质上是独立于其他界面的一个窗口，用于完成一个独立的功能。

所以，定义一个对话框，定位等价于定义一个具有唯一URL路径的页面。只是前者由弹出层实现，后者是页面的切换。

对话框UI弹出过程和页面URL的切换非常类似，那么我们就可以给每一个对话框定义一个全局唯一的ID，然后通过这个ID去显示或者隐藏一个对话框，并且给它传递参数。

尝试设计一个API去做对话框的全局管理

假设我们实现的对话框为NiceModal，那么我们的目标是如下去使用：

const UserInfoModal = NiceModal.create(
    'user-info-modal',
    RealUserInfoModal
)
 
// 创建一个useNiceModal 这样的hook去获取某个id的对话框的操作对象
const modal = useNiceModal('user-info-modal')
 
// 通过 modal.show 显示一个对话框，并能够给它传递参数
modal.show(args)
modal.hide()

可以看到，如果有这样的API，那么无论在哪个层级的组件，只要知道某个Modal的ID，那么就都可以统一使用这些对话框，而不再需要考虑该在哪个层级的组件去定义了。

实现：创建NiceModal组件和相关API

创建一个处理所有对话框的action creator 和 reducer

function showModal(modalId, args) {
    return {
        type: "nice-modal/show",
        payload: {
            modalId,
            args
        }
    }
}
 
function hideModal(modalId, force) {
    return {
        type: "nice-modal/hide",
        payload: {
            modalId,
            force
        }
    }
}

const modalReducer = (state = { hiding: {} }, action) {
    switch (action.type) {
        case "nice-modal/show":
            const {modalId, args} = action.payload
            return {
                ...state,
                // 如果存在 modalId 对应的状态(即args)，就显示这个对话框
                // 只要有参数就认为对话框应该显示，如果没有传递args，在reducer中使用默认值true
                [modalId]: args || true,
                // 定义一个hiding 状态， 用于处理对话框关闭动画
                hiding: {
                    ...state.hiding,
                    [modalId]: false,
                }
            }
        case "nice-modal/hide":
            const { modalId, force: boolean } = action.payload
            // 只有force时才真正移除对话框，否则就是隐藏中hiding
            return action.payload.force 
                ? {
                    ...state,
                    [modalId]: false,
                    hiding: { [modalId]: false }
                  }
                : { ...state, hiding: { [modalId]: true } }
            default:
                return state
    }
}

这段代码的主要思路就是通过Redux的store去存储每个对话框状态和参数。在这里设计了两个action，分别显示和隐藏对话框。

特别注意的是，这里加入了hiding这样的一个状态，用来处理对话框关闭过程动画。

根据使用顺序，首先实现 createNiceModal，

使用容器模式，在对话框不可见时直接返回null，从而不渲染任何内容，

确保即使页面上定义了100个对话框，也不会影响性能。

createNiceModal = (modalId, Comp) => {
    return (props) => {
        const { visible, args } = useNiceModal(modalId)
        if (!visible) return null
        return <Comp {...args} {...props} />
    }
}
 
// 使用
const MyModal = createNiceModal('my-modal', () => {
    return (
        <NiceModal id="my-modal" title="Nice modal">
            Hello NiceModal
        </NiceModal>
    )
})

实现useNiceModal，根据id，封装一些逻辑。

让Redux的action使用起来更方便，在其内部封装对store的操作，从而实现对话框状态管理的逻辑重用。

const modalCallbacks = {}
 
const useNiceModal = (modalId) => {
    const dispatch = useDispatch()
 
    // 封装Redux action 用于显示对话框
    const show = useCallback(
        (args) => {
            dispatch(showModal(modalId, args))
        },
        [dispatch, modalId]
    )
    
    // 封装Redux action 用于隐藏对话框 (force: boolean)
    const hide = useCallback(
        (force) => {
            dispatch(hideModal(modalId, force))
        },
        [dispatch, modalId]
    )
 
    const args = useSelector((s) => s[modalId])
    const hiding = useSelector((s) => s.hiding[modalId])
 
    // 只要有参数就认为对话框应该显示，如果没有传递args，在reducer中使用默认值true
    return { args, hiding, visible: !!args, show, hide }
}

这样，我们就实现了一个NiceModal这样的全局对话管理框架。

这样使用：

import { Button } from 'antd'
import NiceModal, {
    createNiceModal,
    useNiceModal
} from "./NiceModal"
 
const MyModal = createNiceModal("my-modal", () => {
    return (
        <NiceModal id="my-modal" title="Nice Modal">
            Hello World
        </NiceModal>
    )
})
 
function MyModalExample() {
    const modal = useNiceModal("my-modal")
    return (
        <>
            <Button type="primary" onClick={() => modal.show()}>
                Show my modal
            </Button>
            <MyModal />
        </>
    )
}

处理对话框的返回值

如果说对话框和页面这两种UI模式基本上是一致的，都是独立窗口完成独立逻辑。但是在用户交互上，有一定的差别：

对话框可能需要返回值给调用者
而页面切换一般不会关心页面执行的结果是什么

基于上面的NiceModal实现逻辑，现在考虑如何让调用者获得返回值。

我们可以把用户在对话框中的操作看成一个异步操作逻辑，那么用户在完成对话框中内容的操作后，就认为异步操作逻辑完成了。因此我们可以利用Promise来完成这样的逻辑。

那么，我们要实现的API如下：

const modal = useNiceModal('my-modal')
// 实现一个 promise API 来处理返回值
modal.show(args).then(res => {})

事实上，要实现这样一个机制并不困难，就是在 useNiceModal 这个 Hook 的实现中提供一个 modal.resolve 这样的方法，能够去 resolve modal.show 返回的 Promise。

代码的核心思路就是将show 和 resolve 两个函数通过 Promise 联系起来。因此两个函数调用位置不一样，所以我们使用一个局部的临时变量，来存放resolve回调函数。

// 使用一个 object 缓存 promise 的 resolve 回调函数
const modalCallbacks = {};
export const useNiceModal = (modalId) => {
  const dispatch = useDispatch();
  const show = useCallback(
    (args) => {
      return new Promise((resolve) => {
        // 显示对话框时，返回 promise 并且将 resolve 方法临时存起来
        modalCallbacks[modalId] = resolve;
        dispatch(showModal(modalId, args));
      });
    },
    [dispatch, modalId],
  );
  const resolve = useCallback(
    (args) => {
      if (modalCallbacks[modalId]) {
        // 如果存在 resolve 回调函数，那么就调用
        modalCallbacks[modalId](args);
        // 确保只能 resolve 一次
        delete modalCallbacks[modalId];
      }
    },
    [modalId],
  );
  
  // 其它逻辑...
 
  // 将 resolve 也作为返回值的一部分
  return { show, hide, resolve, visible, hiding };
};