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并非在所有退出场景都会触发。例如,移动端浏览器被系统终止时,不能依赖它保护内容。- 不应在这个事件中执行需要等待完成的异步保存。需要防止内容丢失时,可以另外实现定时保存或草稿恢复。
备注:内容仅供参考。
