
本教程将指导如何在 React 应用中,利用 HTML 原生 `
在 React 中实现可等待的 HTML Dialog 模态框
在现代 Web 应用开发中,模态框(Modal Dialog)是常见的交互组件,用于获取用户输入或显示重要信息。传统的 window.alert()、window.confirm() 或 window.prompt() 提供了阻塞式(blocking)的用户体验,即在用户响应之前,后续代码不会执行。在 React 中,我们通常使用状态(state)来控制模态框的显示与隐藏,但这通常是异步的,无法直接实现类似 window.confirm() 那样的“等待”用户输入的行为。
本教程将展示如何结合 HTML 原生
核心思路
实现可等待模态框的关键在于以下两点:
立即学习“前端免费学习笔记(深入)”;
- 状态管理控制显示/隐藏: 使用 React 状态来控制
- Promise 机制实现等待: 当模态框打开时,创建一个 Promise 并将其 resolve 函数存储起来。模态框内的用户操作(例如点击“确认”或“取消”按钮)将调用这个存储的 resolve 函数,并传递操作结果,从而使外部的 await 调用得以继续执行。
为了在不同组件间共享模态框的状态和 resolve 函数,我们需要一个简单的全局状态管理方案。
实现步骤
我们将通过一个简单的 createAtom 函数作为全局状态管理器,来演示这一机制。在实际项目中,你可以替换为 Jotai、Zustand、Redux Toolkit 或 React Context API 等更成熟的状态管理方案。
1. 定义全局状态管理器 createAtom
createAtom 是一个极简的全局状态管理工具,它允许我们创建可订阅的状态原子。
function createAtom(_def) {
const evt = new EventTarget(); // 用于通知组件状态更新
let _value = _def; // 存储当前状态值
// `use` 钩子,让 React 组件订阅状态变化
function use() {
const [, _refresher] = React.useState(0);
React.useEffect(() => {
const handler = () => _refresher(c => c + 1);
evt.addEventListener('notify', handler);
return () => evt.removeEventListener('notify', handler);
}, []);
return _value;
}
// `setValue` 方法,更新状态并通知所有订阅者
function setValue(v) {
_value = v;
evt.dispatchEvent(new Event('notify'));
}
// `value` 方法,获取当前状态值(不触发组件重新渲染)
const value = () => _value;
return { value, setValue, use };
}
// 定义模态框的打开状态和显示信息
const dialogOpen = createAtom(false); // 控制 这里的 createAtom 模拟了一个非常基础的响应式状态系统。dialogOpen 将控制模态框的可见性,info 用于显示操作结果,而 dialogResolve 则是一个关键变量,它将保存模态框打开时创建的 Promise 的 resolve 函数。
2. 创建 Dialog 组件
Dialog 组件负责渲染 HTML 原生
function Dialog() {
const { use } = dialogOpen; // 使用 dialogOpen 状态
return (
);
}3. 定义模态框触发函数 modal
modal 函数是外部组件调用模态框的接口。它返回一个 Promise,并在内部执行以下操作:
- 将 dialogOpen 设置为 true,使模态框显示。
- 将当前 Promise 的 resolve 函数赋值给全局变量 dialogResolve。
function modal() {
return new Promise((resolve) => {
dialogOpen.setValue(true); // 打开模态框
dialogResolve = resolve; // 存储 resolve 函数
});
}4. 创建信息显示组件 Info
这个组件简单地显示 info 状态中的文本,用于演示模态框返回结果。
function Info() {
const txt = info.use();
return {txt};
}5. 创建测试组件 Test
Test 组件包含一个按钮,点击时调用 modal() 函数。由于 modal() 返回一个 Promise,我们可以使用 await 或 .then() 来等待用户在模态框中的操作结果。
function Test() {
// 在现代 React 环境中,可以直接使用 async/await
const handleClick = async () => {
const response = await modal(); // 等待模态框关闭并返回结果
info.setValue("您点击了 " + response + ' @ ' + new Date().toLocaleTimeString());
};
return (
);
}6. 整合所有组件
最后,将所有组件组合到 Main 组件中,并渲染到 DOM。
function Main() {
return (
React Promise Dialog 示例
{/* 模态框组件需要被渲染 */}
);
}
const root = ReactDOM.createRoot(document.getElementById('root'));
root.render();完整示例代码
以下是包含所有部分的完整代码,可以直接在支持 React 18 的环境中运行:
React Promise Dialog 示例
