标题又名：简单弹窗、多弹窗、复杂弹窗怎么做代码和状态的解耦。
关键字：react / modal
问题
实际业务中，不乏弹窗组件中包含大量复杂的业务逻辑。如：
function Order() {
// 省略上百行方法状态
const [visible,setVisible] = useState(false)
const withModalState = useState()
return (
)
} 甚至还有多弹窗的情形。如：
function Order() {
// 省略上百行方法状态
const [visible1,setVisible1] = useState(false)
const [visible2,setVisible2] = useState(false)
const [visible3,setVisible3] = useState(false)
const withModalState1 = useState()
const withModalState2 = useState()
const withModalState3 = useState()
// 省略 不懂多少 handlexx
return (
...
)
}
非常的痛：
- 如果弹窗在处理完内部流程后，又还有返回值，这有又会有一大通的处理函数。
- 如果这些代码都写在一个文件中还是不太容易维护的。
而且随着业务的断增长，每次这么体验很差。
期望的使用方式
因此有没有一种更贴近业务实际的方案。
让弹窗只专注于自己的内部事务，同时又能将控制权交给调用方呢。
或者说我就是不喜欢 Modal 代码堆在一起……
如下：
// Modal1.tsx
export function Modal1(props) return
...
// 不实际挂载 Modal 组件
)
}像这样分离两者的代码，这样处理起来肯定是清爽很多的。
实现思路
实现的思路都是一致的。
- 创建占位符组件，放到应用的某处。
- 将相关状态集管理，并与Modal做好关联。
- 暴露控制权。
因此基于不同的状态管理方案，实现是多种多样的。相信很多大佬都自己内部封装过不少了。
但是在此基础上，我还想要3点。
- API使用简单，但也允许一定配置。
- 返回值类型推导，除了帮我管理 close 和 open 还要让我用起来带提示的。
- 无入侵性，不依赖框架以外的东西。
ez-modal-react
emm......苦于市面上找不到这类产品（感觉同类并不多……讨论的也不多？）
于是我自己开源了一个。回应上文实现思路，可以点击看代码，几百行而已。
并不是突发奇想而来，其实相关特性早就在企业内部是使用多年了。我也是受前辈和社区启发。
基本特性
- 基于Promise封装
- 返回值类型推导
- 没有入侵性，体积小。
使用画面
import EasyModal, { InnerModalProps } from 'ez-modal-react';
+ interface IProps extends InnerModalProps<'fybe?'> /*传入返回值类型*/ {
+ age: number;
+ name: string;
+ }
export const InfoModal = EasyModal.create(
+ (props: Props) => {
return (
{
+ props.hide(); // warn 应有 1 个参数，但获得 0 个。 (property) hide: (result: "fybe?") => void ts(2554)
}}
onCancel={() => {
props.hide(null); //safe hide 接受 null 作为参数。它兼具 hide resolve 两种功能。
}}
>
{props.age}
);
});
+ // warn 类型 "{ name: string; }" 中缺少属性 "age"，但类型 "ModalProps" 中需要该属性。
EasyModal.show(InfoModal, { name: 'foo' }).then((resolve) => {
console.log(resolve);
+ //输出 "fybe?"
}); 也支持用 hook
import EasyModal, { useModal, InnerModalProps } from 'ez-modal-react';
interface IProps extends InnerModalProps<'苏振华'>/* 指定返回值类型 */ {
age: number;
name: string;
}
export const Info = EasyModal.create((props: Props) => {
const modal = useModal();
function handleOk(){
modal.hide(); // ts(2554) (property) hide: (result: "苏振华") => void ts(2554)
}
return 还有一些特性如支持配置 hide 弹窗时的默认行为。（我认为大多数情况下可能用不上）
export const Info = EasyModal.create((props: Props) => {
const modal = useModal();
function handleOk(){
modal.hide();
+ modal.resolve('苏振华') // 需要手动抛出成功
+ modal.remove() // 需要手动注销组件。可用于反复打开弹窗，但是不希望状态被清除的场景。
}
return 当然以上是针对弹窗内有复杂业务场景的状况。
大部分场景都是调用方只在乎 open或close ，仅仅解耦代码这一项好处，就可以让代码变得清爽。
如常用的有展示类，设置类的弹窗，TS类型都用不上。
仓库
其他就不一一介绍了，主要的已经说完了，想了解更多，可以看看仓库。github
Codesandbox Demo
Codesandbox是一个线上集成环境，可以直接打开玩玩。点击 Demo Link 前往
初衷
让弹窗使用更轻松。
包名 ez 开头，是因为我DOTA在东南亚打多了，觉得该词特别贴切。
授之于鱼叉
GitHub仓库地址
：ez-modal-react
觉得有用帮我点个星\~\~\~ 感恩，有啥问题可以提出，看到会回复。如果有需要会持续维护该项目。