Vue / 系统课时
弹窗编辑与提交闭环
弹窗编辑与提交闭环
企业表单弹窗真正难的是把打开、异步加载、校验、提交、防重复点击和关闭清理连成一个可预测的闭环。下面用一个 Vue 3 + TypeScript 组件把状态边界、并发保护和清理策略一次做完整。
学习目标
- 设计弹窗从打开到关闭的清晰状态流,避免脏数据和竞态回填。
- 用 TypeScript 实现加载、校验、提交与防重复点击。
- 在成功、失败和取消路径中正确清理请求与表单状态。
把弹窗看成一次有限生命周期
编辑弹窗不是一个简单的 visible 布尔值。一次完整交互至少经历“打开并重置 → 加载详情 → 可编辑 → 校验 → 提交 → 成功关闭或失败留在原地 → 清理”。只有把这些阶段分开,按钮禁用、错误提示和请求取消才有明确依据。

打开前先清空旧数据,加载中的结果只允许写回当前这一次打开会话;提交时用独立的 submitting 状态做互斥。这样即使用户快速切换记录或连续点击保存,也不会把旧响应写进新弹窗。
实现打开、校验与提交
下面组件假设后端提供 GET /api/users/:id 与 PUT /api/users/:id。GET 返回 { id, name, email },PUT 接收 { name, email } 并返回更新后的同结构对象。
<template>
<dialog v-if="visible" open>
<p v-if="loading">正在加载...</p>
<form v-else @submit.prevent="submit">
<label>
姓名
<input v-model.trim="form.name" :disabled="submitting" />
</label>
<p v-if="errors.name">{{ errors.name }}</p>
<label>
邮箱
<input v-model.trim="form.email" type="email" :disabled="submitting" />
</label>
<p v-if="errors.email">{{ errors.email }}</p>
<p v-if="message">{{ message }}</p>
<button type="button" :disabled="submitting" @click="close">取消</button>
<button type="submit" :disabled="submitting">
{{ submitting ? '提交中...' : '保存' }}
</button>
</form>
</dialog>
</template>
<script setup lang="ts">
import { reactive, ref } from 'vue'
type User = { id: string; name: string; email: string }
type UserForm = Pick<User, 'name' | 'email'>
const emit = defineEmits<{ saved: [user: User] }>()
const visible = ref(false)
const loading = ref(false)
const submitting = ref(false)
const message = ref('')
const currentId = ref<string | null>(null)
const form = reactive<UserForm>({ name: '', email: '' })
const errors = reactive<Partial<Record<keyof UserForm, string>>>({})
let loadController: AbortController | null = null
function reset(): void {
form.name = ''
form.email = ''
errors.name = undefined
errors.email = undefined
message.value = ''
currentId.value = null
}
function validate(): boolean {
errors.name = form.name ? undefined : '请输入姓名'
errors.email = /^[^@\s]+@[^@\s]+\.[^@\s]+$/.test(form.email)
? undefined
: '请输入有效邮箱'
return !errors.name && !errors.email
}
async function openEditor(id: string): Promise<void> {
loadController?.abort()
reset()
visible.value = true
loading.value = true
currentId.value = id
const controller = new AbortController()
loadController = controller
try {
const response = await fetch(`/api/users/${encodeURIComponent(id)}`, {
signal: controller.signal,
})
if (!response.ok) throw new Error(`加载失败:${response.status}`)
const user = (await response.json()) as User
// 只允许当前请求回填,防止快速切换记录时旧响应覆盖新表单。
if (currentId.value === id && loadController === controller) {
form.name = user.name
form.email = user.email
}
} catch (error) {
if ((error as DOMException).name !== 'AbortError') {
message.value = error instanceof Error ? error.message : '加载失败'
}
} finally {
if (loadController === controller) loading.value = false
}
}
async function submit(): Promise<void> {
if (submitting.value || !currentId.value || !validate()) return
submitting.value = true
message.value = ''
let saved: User | null = null
try {
const response = await fetch(
`/api/users/${encodeURIComponent(currentId.value)}`,
{
method: 'PUT',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify(form),
},
)
if (!response.ok) throw new Error(`提交失败:${response.status}`)
saved = (await response.json()) as User
emit('saved', saved)
} catch (error) {
message.value = error instanceof Error ? error.message : '提交失败'
} finally {
submitting.value = false
}
if (saved) close()
}
function close(): void {
if (submitting.value) return
loadController?.abort()
loadController = null
visible.value = false
loading.value = false
reset()
}
defineExpose({ openEditor })
</script>预期结果
调用 openEditor("<ID>"):弹窗先显示“正在加载...”,随后回填对应用户。
姓名或邮箱非法:停留在弹窗内显示校验错误,不发送 PUT 请求。
连续点击“保存”:提交期间按钮被禁用,且 submit() 的互斥判断只允许一个 PUT 请求执行。
提交成功:触发 saved 事件并关闭弹窗;再次打开时不会残留上次表单和错误信息。
加载过程中关闭:未完成的 GET 请求被取消,旧响应不会再次回填。实际接口耗时、用户 ID 和 HTTP 状态码会随环境不同而变化。
为什么要区分 loading 与 submitting
loading 控制“当前数据还不能编辑”,submitting 控制“当前修改不能重复提交”。如果把两者合并成一个 pending,关闭按钮、字段禁用和错误恢复都会失去精度。尤其是提交失败后,应该恢复编辑而不是重新加载详情。
openEditor 每次创建新的 AbortController,并用 currentId 与控制器身份做双重校验。仅仅取消旧请求还不够,因为某些响应可能已经进入事件循环;再校验“这是否仍是当前会话”可以避免竞态写回。
关闭清理与异常边界
关闭弹窗时至少清理表单值、字段错误、全局消息、当前记录 ID 和未完成的加载请求。提交中的关闭在示例里被禁止,避免出现“界面已关但请求成功后又触发父组件刷新”的难解释状态。
如果业务允许用户在提交中强制关闭,就应再为提交请求增加取消策略,并明确服务端是否支持取消后的事务回滚。对大多数普通编辑表单,提交期间锁定关闭动作更简单,也更容易保证状态闭环。