千家信息网

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

发表于:2025-01-16 作者:千家信息网编辑
千家信息网最后更新 2025年01月16日,这篇文章主要介绍"React项目中hook怎么实现展示对话框功能",在日常操作中,相信很多人在React项目中hook怎么实现展示对话框功能问题上存在疑惑,小编查阅了各式资料,整理出简单好用的操作方法
千家信息网最后更新 2025年01月16日React项目中hook怎么实现展示对话框功能

这篇文章主要介绍"React项目中hook怎么实现展示对话框功能",在日常操作中,相信很多人在React项目中hook怎么实现展示对话框功能问题上存在疑惑,小编查阅了各式资料,整理出简单好用的操作方法,希望对大家解答"React项目中hook怎么实现展示对话框功能"的疑惑有所帮助!接下来,请跟着小编一起来学习吧!

React中使用对话框并不容易,主要因为:

  1. 对话框需要在父组件中声明,才能在子组件中控制其是否显示

  2. 给对话框传递参数只能由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     }} // 使用const MyModal = createNiceModal('my-modal', () => {    return (                    Hello 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 (                    Hello World            )}) function MyModalExample() {    const modal = useNiceModal("my-modal")    return (        <>                                    )}

处理对话框的返回值

如果说对话框和页面这两种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 };};

到此,关于"React项目中hook怎么实现展示对话框功能"的学习就结束了,希望能够解决大家的疑惑。理论与实践的搭配能更好的帮助大家学习,快去试试吧!若想继续学习更多相关知识,请继续关注网站,小编会继续努力为大家带来更多实用的文章!

0