一个帮助简化 antd Modal 状态管理的工具

一个帮助简化 antd Modal 状态管理的工具

安装

pnpm add @cicara/better-modal

使用方式

1. 以常规方式创建 Antd 模态，唯一不同的是使用 useModalContext 自动管理Modal的状态。

   import { Input, Modal } from "antd";
   import { useModalContext } from "@cicara/better-modal";
   import { Form } from "antd";
   import { useCallback, useEffect } from "react";
   
   export type MyModalProps = {
     value?: string;
   };
   
   export function MyModal(props: MyModalProps) {
     const modal = useModalContext<string>(); // <- First use modal context
   
     const [form] = Form.useForm();
   
     const handleSubmit = useCallback(
       (values: { name: string }) => {
         modal.resolve(values.name); // <- Close the modal and return the data or message
       },
       [modal.resolve]
     );
   
     useEffect(() => {
       if (!modal.visible) {
         return;
       }
       form.setFieldsValue({ name: props.value });
     }, [props.value]);
   
     return (
       <Modal
         open={modal.visible}
         title="What's your name?"
         onOk={() => form.submit()}
         onCancel={() => modal.reject(new Error("user cancel"))} // <- Close modal with reject and reason
         afterClose={modal.destroy} // Optional, destroy the modal
       >
         <Form form={form} onFinish={handleSubmit} autoComplete="off">
           <Form.Item name="name" rules={[{ required: true }]}>
             <Input placeholder="your name..." />
           </Form.Item>
         </Form>
       </Modal>
     );
   }

2. 使用 useModal<string>(MyModal) React Hook 创建 Modal，并在合适的位置插入 {myModal.placeholder} 以便 Modal 能正确获取上下文。

   import { useModal } from "@cicara/better-modal";
   import { MyModal } from "./my-modal";
   
   export function App() {
     const myModal = useModal(MyModal);
   
     return <div>{myModal.placeholder}</div>;
   }

3. 使用myModal.show函数显示 Modal 并传递参数，show函数返回一个 Promise，它对应于useModalContext中的resolve和reject函数。

   import { Button } from "antd";
   import { useModal } from "@cicara/better-modal";
   import { MyModal } from "./my-modal";
   import { useCallback } from "react";
   
   export function App() {
     const myModal = useModal(MyModal);
   
     const handleOpenModal = useCallback(async () => {
       try {
         const result = await myModal.show<string>({ value: "hungtcs" });
         alert(result);
       } catch (err) {
         alert(err);
       }
     }, []);
   
     return (
       <div>
         <Button onClick={handleOpenModal}>Open Modal</Button>
         {myModal.placeholder}
       </div>
     );
   }

   技术前沿拓展

   前端开发，你的认知不能仅局限于技术内，需要发散思维了解技术圈的前沿知识。细心的人会发现，开发内部工具的过程中，大量的页面、场景、组件等在不断重复，这种重复造轮子的工作，浪费工程师的大量时间。

   介绍一款程序员都应该知道的软件JNPF快速开发平台，很多人都尝试用过它，它是功能的集大成者，任何信息化系统都可以基于它开发出来。

   这是一个基于 Java Boot/.Net Core 构建的简单、跨平台快速开发框架。前后端封装了上千个常用类，方便扩展；集成了代码生成器，支持前后端业务代码生成，实现快速开发，提升工作效率；框架集成了表单、报表、图表、大屏等各种常用的 Demo 方便直接使用；后端框架支持 Vue2、Vue3。如果你有闲暇时间，可以做个知识拓展。

   看完本文如果觉得有用，记得点个赞支持，收藏起来说不定哪天就用上啦～