Vue / 系统课时
检测未保存修改
检测未保存修改
复杂表单最容易丢数据的时刻,不是输入过程,而是用户关闭弹窗、切换路由或刷新页面时。本课用“基线快照 + 实时比较 + 离开守卫”建立统一检测机制,并处理保存后重置基线、浏览器刷新提示与误判边界。
学习目标
- 正确选择表单初始基线并判断当前数据是否已修改
- 在关闭弹窗、切换路由和刷新页面前统一拦截
- 避免界面状态、字段顺序和保存时机造成误判
建立可靠的比较基线
“未保存”不是当前值与组件默认值不同,而是当前业务字段与最近一次成功加载或成功保存后的值不同。因此,异步详情加载完成后要建立基线;保存成功后也要更新基线。加载状态、校验提示、弹窗显隐等界面字段不应参与比较。
普通管理后台表单通常由字符串、数字、布尔值、数组和普通对象组成。示例通过稳定序列化对对象键排序,避免相同数据仅因键顺序不同而被误判。若表单包含 Date、File、Map 等特殊对象,应先转换成可比较的业务值。
统一关闭与离开流程
关闭弹窗、路由跳转和关闭浏览器标签页虽然入口不同,但判断逻辑应复用同一个 isDirty。弹窗和路由可以显示自定义确认文案;浏览器的 beforeunload 只能触发系统确认框,不能保证展示自定义文字。

下面的完整组件同时保护弹窗关闭、Vue Router 路由离开和浏览器刷新。示例只比较业务表单字段,保存成功后立即刷新基线。
vue
<script setup lang="ts">
import { computed, onBeforeUnmount, onMounted, reactive, ref } from 'vue'
import { onBeforeRouteLeave } from 'vue-router'
type UserForm = {
name: string
email: string
roles: string[]
}
const dialogVisible = ref(true)
const form = reactive<UserForm>({
name: 'Alice',
email: 'alice@example.com',
roles: ['editor'],
})
function stableStringify(value: unknown): string {
if (Array.isArray(value)) {
return `[${value.map(stableStringify).join(',')}]`
}
if (value !== null && typeof value === 'object') {
const record = value as Record<string, unknown>
const entries = Object.keys(record)
.sort()
.map((key) => `${JSON.stringify(key)}:${stableStringify(record[key])}`)
return `{${entries.join(',')}}`
}
const encoded = JSON.stringify(value)
return encoded === undefined ? 'null' : encoded
}
const baseline = ref(stableStringify(form))
const isDirty = computed(() => stableStringify(form) !== baseline.value)
function confirmDiscard(): boolean {
return !isDirty.value || window.confirm('存在未保存修改,确定放弃吗?')
}
function requestClose(): void {
if (confirmDiscard()) {
dialogVisible.value = false
}
}
async function save(): Promise<void> {
await Promise.resolve()
baseline.value = stableStringify(form)
window.alert('已保存')
}
function handleBeforeUnload(event: BeforeUnloadEvent): void {
if (!isDirty.value) return
event.preventDefault()
event.returnValue = ''
}
onMounted(() => window.addEventListener('beforeunload', handleBeforeUnload))
onBeforeUnmount(() => window.removeEventListener('beforeunload', handleBeforeUnload))
onBeforeRouteLeave((_to, _from, next) => {
if (confirmDiscard()) {
next()
} else {
next(false)
}
})
</script>
<template>
<section v-if="dialogVisible">
<label>
姓名
<input v-model.trim="form.name" />
</label>
<label>
邮箱
<input v-model.trim="form.email" type="email" />
</label>
<label>
<input v-model="form.roles" type="checkbox" value="editor" />
编辑角色
</label>
<p>{{ isDirty ? '有未保存修改' : '已同步' }}</p>
<button type="button" @click="save">保存</button>
<button type="button" @click="requestClose">关闭</button>
</section>
</template>预期结果
text
初始状态:显示“已同步”
修改任意字段:显示“有未保存修改”
点击关闭或切换路由:出现放弃修改确认提示
保存后再离开:不再提示,直接通过
刷新或关闭标签页:浏览器显示系统确认框处理异步加载与重置
真实页面通常先创建空表单,再请求详情。此时不能在请求前建立基线,否则接口回填会被当成用户修改。正确顺序是“回填业务字段 → 等待必要的数据转换完成 → 更新基线”。点击“重置”时,应明确区分恢复到最近保存值,还是恢复到产品默认值。
关闭确认后若组件仍会复用,还应把表单恢复到基线对应的数据,而不是只把 dialogVisible 设为 false。对于大表单,可在字段变更时记录脏字段集合,避免每次渲染都深度序列化整个对象。
验证关键场景
- 初次打开后不修改,关闭、跳转和刷新都不应误报
- 修改后再改回原值,
isDirty应恢复为false - 保存失败时不得更新基线,保存成功后必须更新
- 接口重新加载另一条记录时,要用新记录重新建立基线
按自己的节奏,确认真正理解。