0

0

React 中使用 Promise 实现可等待的 HTML Dialog 模态框

霞舞

霞舞

发布时间:2025-10-27 09:47:36

|

774人浏览过

|

来源于php中文网

原创

react 中使用 promise 实现可等待的 html dialog 模态框

本教程将指导如何在 React 应用中,利用 HTML 原生 `

` 元素结合 Promise 机制,实现一个类似 `window.confirm()` 的异步阻塞式模态框。通过全局状态管理控制模态框的显示与隐藏,并借助 Promise 捕获用户操作结果,从而实现代码的同步等待效果,提升交互逻辑的清晰度。

在 React 中实现可等待的 HTML Dialog 模态框

在现代 Web 应用开发中,模态框(Modal Dialog)是常见的交互组件,用于获取用户输入或显示重要信息。传统的 window.alert()、window.confirm() 或 window.prompt() 提供了阻塞式(blocking)的用户体验,即在用户响应之前,后续代码不会执行。在 React 中,我们通常使用状态(state)来控制模态框的显示与隐藏,但这通常是异步的,无法直接实现类似 window.confirm() 那样的“等待”用户输入的行为。

本教程将展示如何结合 HTML 原生

元素和 JavaScript Promise,在 React 中构建一个能够“等待”用户响应的模态框,从而使调用方代码能够以同步的方式处理用户交互结果。

核心思路

实现可等待模态框的关键在于以下两点:

立即学习前端免费学习笔记(深入)”;

  1. 状态管理控制显示/隐藏: 使用 React 状态来控制 元素的 open 属性,从而决定其是否可见。
  2. 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); // 控制  的 open 属性
const info = createAtom('');          // 用于显示模态框返回的结果信息

// 存储 Promise 的 resolve 函数,以便模态框关闭时调用
let dialogResolve;

这里的 createAtom 模拟了一个非常基础的响应式状态系统。dialogOpen 将控制模态框的可见性,info 用于显示操作结果,而 dialogResolve 则是一个关键变量,它将保存模态框打开时创建的 Promise 的 resolve 函数。

LongCat AI
LongCat AI

美团推出的AI对话问答工具

下载
2. 创建 Dialog 组件

Dialog 组件负责渲染 HTML 原生

元素。它的 open 属性由 dialogOpen 状态控制。当用户点击“是”或“取消”按钮时,它会调用之前存储的 dialogResolve 函数,并传递相应的操作结果,同时将 dialogOpen 设置为 false 来关闭模态框。

function Dialog() {
  const { use } = dialogOpen; // 使用 dialogOpen 状态
  return (
     {/* open 属性控制模态框显示 */}
      

请选择您的操作:

); }
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 示例