Vue / 系统课时

新增用户数据

新增用户数据

本课完成一个可复用的新增用户弹窗:打开时初始化表单,输入时执行规则校验,提交成功后关闭弹窗并重新加载用户列表,提交失败时保留现场供用户修正。

学习目标

  • 使用响应式对象维护新增表单和提交状态。
  • 完成表单初始化、校验、提交与关闭清理。
  • 在新增成功后刷新列表,避免页面数据与服务端不一致。

梳理新增流程与状态

新增操作同时涉及列表、弹窗、表单和接口。关键不是“显示一个对话框”,而是保证每次打开都从干净状态开始,并让成功、失败两条路径都可预测。

新增用户弹窗的数据流与状态变化

示例接口约定如下,实际项目只需替换基础地址或字段名称。

请求 用途 约定
GET /api/users 加载用户列表 返回 User[]
POST /api/users 创建用户 接收新增表单字段

实现新增用户弹窗

下面的单文件组件包含列表加载、弹窗表单、校验、提交和刷新逻辑。项目需要已安装 Vue 3、Element Plus 与 Axios,并在入口文件中完成 Element Plus 注册。

vue
<template>
  <section>
    <el-button type="primary" @click="openCreate">新增用户</el-button>

    <el-table v-loading="listLoading" :data="users" style="margin-top: 16px">
      <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>

    <el-dialog
      v-model="dialogVisible"
      title="新增用户"
      width="520px"
      :close-on-click-modal="false"
      @closed="resetCreateForm"
    >
      <el-form ref="formRef" :model="form" :rules="rules" label-width="88px">
        <el-form-item label="用户名" prop="username">
          <el-input v-model.trim="form.username" maxlength="30" />
        </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" @click="submitCreate">
          保存
        </el-button>
      </template>
    </el-dialog>
  </section>
</template>

<script setup lang="ts">
import { nextTick, 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
}

type CreateUserPayload = Omit<User, 'id'>

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

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

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

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

const rules: FormRules<CreateUserPayload> = {
  username: [
    { required: true, message: '请输入用户名', trigger: 'blur' },
    { min: 3, max: 30, message: '长度应为 3 到 30 个字符', trigger: 'blur' }
  ],
  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 openCreate() {
  Object.assign(form, emptyForm())
  dialogVisible.value = true
  await nextTick()
  formRef.value?.clearValidate()
}

function resetCreateForm() {
  Object.assign(form, emptyForm())
  formRef.value?.clearValidate()
}

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

  submitting.value = true
  try {
    // 显式复制字段,避免把临时状态或组件内部属性提交给接口。
    await request.post('/users', { ...form })
    ElMessage.success('用户新增成功')
    dialogVisible.value = false
    await loadUsers()
  } catch {
    ElMessage.error('新增失败,请检查用户名是否重复')
  } finally {
    submitting.value = false
  }
}

onMounted(loadUsers)
</script>

预期结果

text
1. 点击“新增用户”后,弹窗显示默认角色“编辑员”和启用状态。
2. 必填项为空时不会发送请求,并显示对应校验信息。
3. 校验通过后发送 POST /api/users。
4. 接口成功后弹窗关闭,并再次发送 GET /api/users 刷新表格。

处理关闭与重复提交

关闭弹窗时要清理表单值和校验提示,否则下次打开会看到上一次输入。提交按钮使用 submitting 控制加载状态,既能给出反馈,也能阻止用户连续点击产生重复请求。

刷新列表应发生在创建接口成功之后。若先关闭弹窗、却没有重新拉取数据,页面会继续显示旧列表;若接口失败,则应保持弹窗和用户输入,便于直接修正后再次提交。

验收新增功能

先提交空表单,确认每个必填字段都有提示且网络面板没有新增请求。再填写合法数据,确认请求体只包含用户名、昵称、邮箱、角色和状态,成功后列表出现新记录。最后主动制造接口错误,确认弹窗不会关闭。

接口返回结构若不是数组,应只调整 loadUsers 中的数据读取位置,例如改为 response.data.data,不要把响应适配逻辑散落到模板中。

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

目录与阅读设置

阅读设置

17

记录一个想法

新增用户数据

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

登录哪都通