React hook实现展示对话框_综合

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.payloadreturn {...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时才真正移除对话框，否则就是隐藏中hidingreturn 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 nullreturn <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中使用默认值truereturn { 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 };
};