Vue / 系统课时

编辑用户数据

编辑用户数据

本课完成用户编辑链路:从列表选择记录,按用户 ID 加载最新详情并回填表单,锁定不可修改字段,只提交允许变更的数据,成功后刷新列表。

学习目标

  • 在打开编辑弹窗时异步加载并回填用户详情。
  • 区分展示字段与可编辑字段,构造最小更新请求。
  • 处理加载、提交、关闭和列表同步等状态。

设计编辑流程与字段边界

编辑不能直接把列表行数据当作最终详情。列表通常只保留摘要字段,而详情接口才是更新前的可信数据源。正确顺序是先打开弹窗并进入加载态,再请求详情、回填表单,最后允许用户提交。

编辑用户详情加载与更新流程

本例把 id 和 username 视为不可编辑字段,只允许修改昵称、邮箱、角色和启用状态。更新请求也只发送这些字段,避免服务端误接收主键或账号名。

实现详情回填与更新

下面的组件可直接放入已配置 Vue 3、Element Plus 与 Axios 的项目中。它使用请求序号忽略过期详情响应,避免用户快速切换记录时旧请求覆盖新表单。

vue
<template>
  <section>
    <el-table v-loading="listLoading" :data="users">
      <el-table-column prop="username" label="用户名" />
      <el-table-column prop="nickname" label="昵称" />
      <el-table-column prop="email" label="邮箱" />
      <el-table-column prop="role" label="角色" />
      <el-table-column label="操作" width="100">
        <template #default="{ row }">
          <el-button link type="primary" @click="openEdit(row)">编辑</el-button>
        </template>
      </el-table-column>
    </el-table>

    <el-dialog
      v-model="dialogVisible"
      title="编辑用户"
      width="520px"
      :close-on-click-modal="false"
      @closed="resetEditForm"
    >
      <el-form
        ref="formRef"
        v-loading="detailLoading"
        :model="form"
        :rules="rules"
        label-width="88px"
      >
        <el-form-item label="用户 ID">
          <el-input :model-value="String(form.id || '')" disabled />
        </el-form-item>
        <el-form-item label="用户名">
          <el-input v-model="form.username" disabled />
        </el-form-item>
        <el-form-item label="昵称" prop="nickname">
          <el-input v-model.trim="form.nickname" maxlength="30" />
        </el-form-item>
        <el-form-item label="邮箱" prop="email">
          <el-input v-model.trim="form.email" />
        </el-form-item>
        <el-form-item label="角色" prop="role">
          <el-select v-model="form.role" style="width: 100%">
            <el-option label="管理员" value="admin" />
            <el-option label="编辑员" value="editor" />
          </el-select>
        </el-form-item>
        <el-form-item label="启用状态">
          <el-switch v-model="form.status" :active-value="1" :inactive-value="0" />
        </el-form-item>
      </el-form>

      <template #footer>
        <el-button :disabled="submitting" @click="dialogVisible = false">
          取消
        </el-button>
        <el-button
          type="primary"
          :loading="submitting"
          :disabled="detailLoading"
          @click="submitEdit"
        >
          保存修改
        </el-button>
      </template>
    </el-dialog>
  </section>
</template>

<script setup lang="ts">
import { onMounted, reactive, ref } from 'vue'
import axios from 'axios'
import { ElMessage } from 'element-plus'
import type { FormInstance, FormRules } from 'element-plus'

type UserRole = 'admin' | 'editor'

interface User {
  id: number
  username: string
  nickname: string
  email: string
  role: UserRole
  status: 0 | 1
}

interface UpdateUserPayload {
  nickname: string
  email: string
  role: UserRole
  status: 0 | 1
}

const request = axios.create({
  baseURL: '/api',
  timeout: 10000
})

const users = ref<User[]>([])
const listLoading = ref(false)
const dialogVisible = ref(false)
const detailLoading = ref(false)
const submitting = ref(false)
const formRef = ref<FormInstance>()
let detailRequestId = 0

const emptyForm = (): User => ({
  id: 0,
  username: '',
  nickname: '',
  email: '',
  role: 'editor',
  status: 1
})

const form = reactive<User>(emptyForm())

const rules: FormRules<User> = {
  nickname: [{ required: true, message: '请输入昵称', trigger: 'blur' }],
  email: [
    { required: true, message: '请输入邮箱', trigger: 'blur' },
    { type: 'email', message: '邮箱格式不正确', trigger: 'blur' }
  ],
  role: [{ required: true, message: '请选择角色', trigger: 'change' }]
}

async function loadUsers() {
  listLoading.value = true
  try {
    const response = await request.get<User[]>('/users')
    users.value = response.data
  } catch {
    ElMessage.error('用户列表加载失败')
  } finally {
    listLoading.value = false
  }
}

async function openEdit(row: User) {
  const currentRequestId = ++detailRequestId
  Object.assign(form, emptyForm())
  dialogVisible.value = true
  detailLoading.value = true
  formRef.value?.clearValidate()

  try {
    const response = await request.get<User>(`/users/${row.id}`)
    // 只允许最后一次打开操作写入表单,防止旧响应覆盖新记录。
    if (currentRequestId !== detailRequestId) return
    Object.assign(form, response.data)
  } catch {
    if (currentRequestId === detailRequestId) {
      ElMessage.error('用户详情加载失败')
      dialogVisible.value = false
    }
  } finally {
    if (currentRequestId === detailRequestId) {
      detailLoading.value = false
    }
  }
}

function resetEditForm() {
  detailRequestId += 1
  Object.assign(form, emptyForm())
  formRef.value?.clearValidate()
  detailLoading.value = false
}

async function submitEdit() {
  if (!form.id || detailLoading.value) return

  const valid = await formRef.value?.validate().catch(() => false)
  if (!valid) return

  const payload: UpdateUserPayload = {
    nickname: form.nickname,
    email: form.email,
    role: form.role,
    status: form.status
  }

  submitting.value = true
  try {
    await request.put(`/users/${form.id}`, payload)
    ElMessage.success('用户信息更新成功')
    dialogVisible.value = false
    await loadUsers()
  } catch {
    ElMessage.error('更新失败,请稍后重试')
  } finally {
    submitting.value = false
  }
}

onMounted(loadUsers)
</script>

预期结果

text
1. 点击某行“编辑”后发送 GET /api/users/<ID>,详情返回前表单显示加载状态。
2. 用户 ID 与用户名不可修改,昵称、邮箱、角色和状态可以编辑。
3. 保存时发送 PUT /api/users/<ID>,请求体不包含 id 和 username。
4. 更新成功后弹窗关闭,并重新请求用户列表;失败时保留当前输入。

其中 <ID> 会替换为当前记录的真实用户 ID。若后端使用 PATCH 表示局部更新,只需把 request.put 改为 request.patch,其余表单逻辑不变。

为什么不直接使用列表行数据

列表数据可能经过分页裁剪、字段格式化或权限脱敏,直接回填容易遗漏字段,也可能覆盖服务端刚发生的修改。打开弹窗时重新请求详情,可以确保编辑基于最新版本。

请求序号解决了另一个常见问题:用户连续点击两条记录时,第一个请求可能后返回。只有最后一次请求能够写入表单,旧响应会被忽略,从而避免“标题是用户 B,内容却是用户 A”的错位。

验证更新链路

在浏览器网络面板中检查三件事:打开弹窗时详情请求只携带当前 ID;保存请求体只包含允许修改的字段;成功后确实重新加载列表。再让详情接口返回错误,确认弹窗关闭且不会保留半成品数据。

不可编辑字段应同时在界面和请求层受控。仅把输入框设为禁用还不够,如果提交时直接发送整个 form,仍可能把这些字段带给后端,因此本例显式构造 UpdateUserPayload。

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

目录与阅读设置

阅读设置

17

记录一个想法

编辑用户数据

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

登录哪都通