Vue / 系统课时

弹窗编辑与提交闭环

弹窗编辑与提交闭环

企业表单弹窗真正难的是把打开、异步加载、校验、提交、防重复点击和关闭清理连成一个可预测的闭环。下面用一个 Vue 3 + TypeScript 组件把状态边界、并发保护和清理策略一次做完整。

学习目标

  • 设计弹窗从打开到关闭的清晰状态流,避免脏数据和竞态回填。
  • 用 TypeScript 实现加载、校验、提交与防重复点击。
  • 在成功、失败和取消路径中正确清理请求与表单状态。

把弹窗看成一次有限生命周期

编辑弹窗不是一个简单的 visible 布尔值。一次完整交互至少经历“打开并重置 → 加载详情 → 可编辑 → 校验 → 提交 → 成功关闭或失败留在原地 → 清理”。只有把这些阶段分开,按钮禁用、错误提示和请求取消才有明确依据。

弹窗编辑从打开到清理的状态流

打开前先清空旧数据,加载中的结果只允许写回当前这一次打开会话;提交时用独立的 submitting 状态做互斥。这样即使用户快速切换记录或连续点击保存,也不会把旧响应写进新弹窗。

实现打开、校验与提交

下面组件假设后端提供 GET /api/users/:id 与 PUT /api/users/:id。GET 返回 { id, name, email },PUT 接收 { name, email } 并返回更新后的同结构对象。

vue
<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>

预期结果

text
调用 openEditor("<ID>"):弹窗先显示“正在加载...”,随后回填对应用户。
姓名或邮箱非法:停留在弹窗内显示校验错误,不发送 PUT 请求。
连续点击“保存”:提交期间按钮被禁用,且 submit() 的互斥判断只允许一个 PUT 请求执行。
提交成功:触发 saved 事件并关闭弹窗;再次打开时不会残留上次表单和错误信息。
加载过程中关闭:未完成的 GET 请求被取消,旧响应不会再次回填。

实际接口耗时、用户 ID 和 HTTP 状态码会随环境不同而变化。

为什么要区分 loading 与 submitting

loading 控制“当前数据还不能编辑”,submitting 控制“当前修改不能重复提交”。如果把两者合并成一个 pending,关闭按钮、字段禁用和错误恢复都会失去精度。尤其是提交失败后,应该恢复编辑而不是重新加载详情。

openEditor 每次创建新的 AbortController,并用 currentId 与控制器身份做双重校验。仅仅取消旧请求还不够,因为某些响应可能已经进入事件循环;再校验“这是否仍是当前会话”可以避免竞态写回。

关闭清理与异常边界

关闭弹窗时至少清理表单值、字段错误、全局消息、当前记录 ID 和未完成的加载请求。提交中的关闭在示例里被禁止,避免出现“界面已关但请求成功后又触发父组件刷新”的难解释状态。

如果业务允许用户在提交中强制关闭,就应再为提交请求增加取消策略,并明确服务端是否支持取消后的事务回滚。对大多数普通编辑表单,提交期间锁定关闭动作更简单,也更容易保证状态闭环。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

弹窗编辑与提交闭环

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通