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,不要把响应适配逻辑散落到模板中。
按自己的节奏,确认真正理解。