React Hook Form 与 Zustand:表单、草稿和服务端状态如何分工
本文目录
把每个输入框的值都塞进全局状态,不会自动得到可靠的表单。字段校验、触碰状态、错误提示和提交状态属于表单;跨页面草稿属于产品状态;服务器保存的版本属于远端数据。明确这三层,能减少重复更新与数据覆盖。
状态放在哪里
React Hook Form 管理输入注册、校验和提交;Zustand 可以管理跨组件共享的草稿或 UI 偏好,但不替代请求缓存和服务端权限。URL 适合分页、搜索和可分享的筛选条件。密码、验证码和访问令牌不进入持久化草稿。
不要把“少重渲染”写成“零重渲染”:订阅字段、受控组件和校验反馈都可能触发渲染。先用 profiler 找到真正昂贵的组件,再缩小订阅范围。
一个可以提交的草稿表单
import { useForm } from 'react-hook-form';
type Draft = { title: string; summary: string };
export function DraftForm({ save }: { save: (data: Draft) => Promise<void> }) {
const { register, handleSubmit, reset, setError, formState } = useForm<Draft>({
defaultValues: { title: '', summary: '' },
});
const submit = handleSubmit(async values => {
try {
await save(values);
reset(values);
} catch {
setError('root', { message: '保存失败,内容已保留,请重试。' });
}
});
return <form onSubmit={submit}>
<fieldset disabled={formState.isSubmitting}>
<legend>文章草稿</legend>
<label htmlFor="draft-title">标题</label>
<input id="draft-title" aria-invalid={!!formState.errors.title}
aria-describedby="draft-title-error"
{...register('title', {
required: '请输入标题', maxLength: { value: 120, message: '最多 120 个字符' },
validate: value => value.trim().length > 0 || '标题不能只有空格',
})} />
<p id="draft-title-error" role="alert">{formState.errors.title?.message}</p>
<label htmlFor="draft-summary">摘要</label>
<textarea id="draft-summary" {...register('summary', { maxLength: 500 })} />
{formState.errors.root && <p role="alert">{formState.errors.root.message}</p>}
<button disabled={formState.isSubmitting}>保存草稿</button>
{formState.isDirty && <span>有未保存修改</span>}
</fieldset>
</form>;
}
save 是项目 API 适配器,失败必须 reject。这个基础示例用 fieldset 在提交期间禁用字段,成功后才 reset,建立新的“已保存基线”。更复杂的编辑器可以允许继续输入,但不能照搬无条件 reset。
允许继续输入时,保存的是快照
设提交时标题为 A,网络等待期间用户改成 B。响应确认的是 A;界面必须保留 B,并把“已保存”基线更新为 A。将服务端结果直接写回表单,会让 B 消失;只显示“保存成功”也会让用户误以为 B 已持久化。
可以将草稿分成 current、saved、submitted 三份不可变值:发请求时捕获 submitted;响应时只更新 saved。如果 current 仍等于 submitted,才用规范化后的响应替换 current 并标记干净;否则保留 current,显示“刚才继续编辑的内容仍待保存”。
比较必须适合数据模型:JSON 对象键顺序变化不算内容变化,但歌单数组顺序变化算。日期、二进制和富文本节点要用自己的规范化规则,不能把 JSON.stringify 当成所有对象的通用相等判断。
请求状态之外还要防重复提交;短时间内连续事件可能先于按钮重新渲染,可以使用同步锁。失败时不改变 saved,也不清空 current。切换文档或配置分组后,旧请求不能修改新页面;仅比较分组名称还不够,“A → B → A”应通过加载代次或请求 ID 区分。
这些措施解决当前页面与晚响应的关系;两个管理员同时修改,仍要依靠服务端ETag 与条件写入拒绝旧版本。页面内状态保护不是数据库并发控制。
JSON 编辑器不能只保存上一个合法对象
JSON 输入到一半时,缺括号或逗号是正常中间状态。应保留原始文本、上一个合法对象和已保存基线,分别管理。解析失败只显示关联的错误,不把文本框重新渲染为上一个合法对象,否则用户永远输入不完整。
切换到结构化表单前先验证;不合法就保留 JSON 模式并解释原因。保存时要求根节点符合配置对象约束,不能把数组、null 或字符串当成有效配置。发生格式错误仍应计为未保存修改,离开时继续提醒。
错误需显示在编辑区附近,并通过 aria-describedby 与控件关联;不能只有会自动消失的 toast。保存期间继续编辑错误 JSON 时,也不能被旧响应修正为旧对象。
Zustand 草稿隔离
草稿 key 应至少含账号与文档 ID,并记录内容版本和更新时间。换账号清理旧账号内存,服务端文档变更时不要直接覆盖本地草稿,先提示冲突。持久化只保存白名单字段,并限制大小;旧 schema 升级要有迁移或丢弃路径。
共享 store 的选择器只订阅所需字段,更新对象时保持不可变。列表页也不应订阅整份大文档正文,否则一个字符的变化可能牵动无关页面。
服务端校验仍是最终边界
前端 required 和 maxLength 只是即时反馈。后端还需检查类型、长度、资源权限、当前版本与发布规则。提交版本号或 ETag,让并发编辑返回明确冲突,而不是最后一个请求覆盖所有人。
异步字段校验要去抖并取消过期请求。后返回的“标题可用”不能覆盖更新后标题的结果。只对可安全重试的读请求自动重试;创建记录要使用幂等机制。
离开与恢复
isDirty 为真时,站内导航提供保存、放弃和继续编辑。关闭标签页可用 beforeunload,但移动端关闭进程不保证触发;自动草稿是补充,不是无限期保存敏感内容的理由。用户明确放弃后再清理对应草稿,不能提前丢数据。
验证空白标题、超长内容、弱网失败、重复点击、会话失效、冲突、返回编辑和账号切换。尤其测试“提交中继续输入”以及“加载旧草稿晚于最新服务器内容”这两类竞态。
跨框架案例:离页确认为什么会“取消了还是跳走”
表单库能计算 dirty,却不掌管浏览器历史与框架路由。下面补充一个本站个人中心实际遇到的案例;它属于跨框架的导航适配,React Hook Form、Zustand 与 Astro 不是必须同时安装的组合。
用户修改昵称后点击书架,产品期望是:继续编辑就保留原位置、输入与搜索条件;放弃修改才前往书架。实现时要分别处理站内链接、程序跳转、历史后退,以及刷新或关闭窗口。它们不是同一种事件。
| 离开方式 | 需要保护的内容 | 常见错误 |
|---|---|---|
| 普通站内链接 | 输入、页面与目标链接意图 | 路由请求已经启动后,只弹一个没有接入路由的确认框 |
| 程序调用导航 | 当前请求、取消信号、离页决定 | 只拦a标签,登录过期或业务跳转仍然丢内容 |
| 浏览器后退/前进 | 页面内容与历史位置共同一致 | 留住DOM,却让URL停在上一页;下一次后退距离也变了 |
| 刷新、关闭或离开本站 | 浏览器支持的原生离页提醒 | 试图用自定义dialog阻塞页面关闭,或承诺移动端必定触发事件 |
先弄清取消的是哪一层
DOM事件的preventDefault只设置事件的取消标记,后续由消费这个事件的代码决定怎么做。不能看到事件可取消,就推断“取消后用户一定留在原页面”。
本站排查时安装的是Astro 5.18.1。查看该版本路由源码发现:取消astro:before-preparation之后,未被请求信号终止的导航会转为整页地址跳转。因此“在这个事件里调用confirm,用户选取消就preventDefault”的写法,恰好可能走进另一条离开路径。
这是对已核对版本的实现判断,不能当成所有Astro版本、React Router或其他路由的统一规则。升级后应重新核对API契约与实际返回流程。可对照Astro 5.18.1路由源码与路由生命周期接口。
普通站内点击可以在路由启动前询问,放弃后再调用框架导航。需要保留左键、同源、正常目标窗口等约束:Ctrl/Command打开新标签、download、外部地址、mailto和同文档锚点不能全都强行变成当前页跳转;replace历史意图也不能悄悄改为push。
程序导航需要在适配器层等待决定,并与该次请求的AbortSignal关联。Astro提供可包装的loader,但官方接口描述不等于一个跨版本的“离页拦截器”承诺。取消时不能为了让Promise结束而加载目标页,也不能把所有Promise错误全局吞掉;只能识别自己创建的取消结果,其他加载失败仍然要呈现或上报。
把一次离开当成一笔可取消的请求
可以把流程理解为以下状态,而不是一个全局confirmed布尔值:
干净 → 有修改 → 正在询问
├─ 继续编辑 / Escape → 有修改,保持输入和位置
├─ 放弃并离开 → 已批准本次跳转 → 卸载与清理
└─ 请求被替代 / 页面已卸载 → 取消本次询问
每次询问保存自己的代次、取消信号和resolve。收到用户同意后,还要确认页面活着、请求仍是当前代次、账号和表单上下文没变。否则一次迟到的同意,会把用户刚打开的另一个页面又带走。
如果增加“保存并离开”,保存失败必须继续留在表单,不能在finally里跳转。保存期间又输入了新内容,服务器确认的是旧提交快照;应保留新输入并再次明确处理,而不是悄悄把它算成已保存。本文前面的current、submitted和saved分工在这里仍然适用。
站点级的退出登录、切换账号也要单独定义意图:服务端已经拒绝的会话不能靠一个离页弹窗继续使用权限;同时,能保留的非敏感草稿也不应被无说明地清空。这是产品与认证协作的规则,不是路由取消能代替的服务端授权。
后退时,URL和DOM必须一起恢复
popstate到达时,浏览器历史已经移动。假设历史索引为10的编辑页,要返回索引8,距离就是-2;不要一律history.go(1),否则多步后退、前进以及同页锚点都会出错。
一种项目适配方案是:记录来源索引,恢复到来源后询问;继续编辑则保持原位,放弃后重放最初的距离。恢复过程必须避免被当成新的离开,再次打开询问或无限来回。也不能用不断pushState来“封死后退”,那会污染历史并让用户失去正常导航。
历史索引属于具体路由的实现约定。不能把随手写进history.state的字段当成通用浏览器标准;进入页面时没有可靠索引、跨文档离开、不同浏览器手势等情况,都需要明确的回退策略和实际浏览器验证。模拟事件的调用顺序不等于真实框架与浏览器的事件顺序。
dialog关闭事件也会迟到
本站真实返回测试中,出现过“输入还在,但新的离页确认框立刻消失”。原因不是CSS:请求A取消时调用dialog.close,close事件被排队;请求B随即showModal;A的close事件后来才到,如果无条件处理,就会把B一起取消。
下面是确认器中的关键片段,settleCurrent代表只结算当前询问、移除其取消监听并关闭弹窗的函数,不能直接当作完整路由模块粘贴:
dialog.addEventListener('close', () => {
// 旧close事件到达时,新请求可能已经重新打开同一个dialog。
if (!dialog.open) settleCurrent(false);
});
dialog.addEventListener('cancel', event => {
event.preventDefault();
settleCurrent(false); // Escape保持在原表单。
});
这里的open检查只解决共享dialog的旧关闭事件;请求代次、旧AbortSignal移除、页面卸载清理仍需独立处理。showModal失败时也要结算本次询问,不能让导航永远等待。HTML标准把close事件放入任务队列,参见dialog关闭算法。
刷新保护与自动草稿分工
beforeunload只负责浏览器允许的通用提醒,页面无法指定其中的文字。移动端切到其他应用再被系统终止,可能没有机会触发它,所以它不等于自动保存。
通用实现建议只在确有未保存修改时挂载beforeunload,保存或还原后移除,避免不必要的页面生命周期影响;这项建议不是声称所有浏览器、所有站内表单已逐一验证。低频保存允许落盘的非敏感草稿、可见性变化时及时记录、再次进入时提供恢复,属于另一层能力。不要把密码、验证码或访问令牌写进草稿。详细浏览器边界见MDN beforeunload。
怎样证明用户真的没有丢内容
至少完成一次连续流程:修改 → 点击离开 → 继续编辑 → 再次后退 → 继续编辑 → 再次后退并放弃 → 前进返回。逐步检查URL、输入值、已保存基线、弹窗焦点和真正到达的页面;不能只断言confirm调用了几次。
自动回归还要模拟“旧请求abort → close事件排队 → 新询问打开 → 旧事件到达”,确认新询问仍在等待;页面卸载后迟到的同意不得导航。浏览器验收覆盖短屏、长文案、Escape、返回恢复和语言切换;320px截图没有溢出,也不能代替真实手机软键盘与系统返回手势。
这次经验补充了原文章的离开/恢复部分,没有改变其表单与草稿的主题。当前案例来自本站实际个人中心排查,示例是职责与时序说明,不承诺所有框架、手机浏览器和表单都已完成同样的实现与验收。
官方资料
资源发现来源:25 项前端资源清单。本文专注表单与草稿协作,不重复状态管理总览。
留言提交后直接公开,请友善交流。