PAYATHON 2026

React + JS 如何在用户离开文本编辑器页面时弹出提醒?

数据小许

可以根据已有的编辑状态,在 useEffect 中注册 beforeunload 事件监听。用户刷新、关闭标签页或导航到需要卸载当前文档的地址时,可以请求浏览器显示离开确认框。

React 应用内部的路由切换还需要通过路由库提供的导航拦截机制处理,单靠 beforeunload 无法覆盖。

根据编辑状态注册监听

下面使用 textarea 演示。接入实际文本编辑器时,把相同的状态更新逻辑放到编辑器的内容变化回调中即可。

import { useEffect, useState } from "react";

export default function TextEditor() {
  const [text, setText] = useState("");
  const [isDirty, setIsDirty] = useState(false);

  useEffect(() => {
    if (!isDirty) return;

    function handleBeforeUnload(event) {
      event.preventDefault();
      event.returnValue = "";
    }

    window.addEventListener("beforeunload", handleBeforeUnload);

    return () => {
      window.removeEventListener("beforeunload", handleBeforeUnload);
    };
  }, [isDirty]);

  function handleChange(event) {
    setText(event.target.value);
    setIsDirty(true);
  }

  return (
    <textarea
      aria-label="文本编辑器"
      value={text}
      onChange={handleChange}
    />
  );
}

isDirty 为 true 时注册监听,状态变回 false 或组件卸载时,由清理函数移除监听。这里可以沿用已有的 state。

event.preventDefault() 用于请求浏览器显示离开确认框,event.returnValue = "" 用于兼容仍依赖该属性的实现。浏览器是否显示确认框由其自行决定。

保存成功后清除编辑状态

如果提醒的目的是防止未保存内容丢失,应让 isDirty 表示“存在未保存的修改”。保存成功后调用:

setIsDirty(false);

不要在点击保存按钮时就清除状态,应等保存成功后再清除。如果保存期间仍允许输入,还要确认保存的是当前内容,避免将保存过程中新增的修改也标记为已保存。

在上面的示例中,只要发生输入,状态就会设为 true。如果希望用户撤销全部修改后不再看到提醒,需要比较当前内容与最近一次保存的内容。

站内路由切换需要单独处理

使用前端路由时,切换 URL 可能只更新组件,不会卸载当前文档,因此也不会触发 beforeunload。

这种情况需要使用当前路由库及版本支持的导航拦截机制:存在未保存修改时拦截导航,用户确认后继续,取消则留在编辑页面。具体 API 需要根据项目使用的路由库和版本选择。

不要只在编辑器的 onBlur 中处理:输入框失去焦点也可能只是用户点击了工具栏,并不代表要离开页面。

浏览器确认框的限制

  • 确认框通常显示浏览器自己的提示文字,不能通过 returnValue 自定义文案。
  • 浏览器通常要求页面发生过用户交互,才允许显示提示;用户在编辑器中输入通常满足这一条件。
  • beforeunload 并非在所有退出场景都会触发。例如,移动端浏览器被系统终止时,不能依赖它保护内容。
  • 不应在这个事件中执行需要等待完成的异步保存。需要防止内容丢失时,可以另外实现定时保存或草稿恢复。

备注:内容仅供参考。