Vue / 系统课时
用户与角色管理
用户与角色管理
本节完成一个可落地的用户管理页面:支持条件查询、分页展示、创建与编辑用户、启停账号,以及为用户分配角色。重点不是堆出 CRUD,而是把表格、表单、接口调用和类型约束组合成可维护的后台模块。
学习目标
- 用 TypeScript 为用户、角色和查询参数建立稳定的数据模型。
- 完成用户列表查询、表单新增与编辑、状态变更和角色分配。
- 用统一的加载、校验与刷新流程保证操作结果可验证。
先定义页面需要的数据契约
企业后台的用户页通常同时依赖用户列表、角色列表和多个写接口。先把接口模型固定下来,组件内部就不必反复猜测字段结构,也能避免把后端 DTO 直接扩散到视图代码。
ts
export interface RoleOption {
id: number
name: string
}
export interface UserItem {
id: number
username: string
displayName: string
enabled: boolean
roleIds: number[]
}
export interface UserQuery {
keyword: string
enabled?: boolean
page: number
pageSize: number
}
export interface UserForm {
id?: number
username: string
displayName: string
roleIds: number[]
}这组类型本身不产生控制台输出。生效后,列表查询、表单提交和角色选择都会受到静态类型检查;可通过 IDE 类型提示和 vue-tsc --noEmit 验证字段是否一致。
组织列表查询与刷新
页面加载后先查询角色选项,再按查询条件加载用户。所有新增、编辑、状态变更和角色分配成功后都回到同一个 loadUsers,避免每个操作各自维护一套表格状态。
ts
<script setup lang="ts">
import { onMounted, reactive, ref } from 'vue'
import type { RoleOption, UserItem, UserQuery } from './types'
import { getRoles, getUsers } from './user-api'
const loading = ref(false)
const users = ref<UserItem[]>([])
const roles = ref<RoleOption[]>([])
const total = ref(0)
const query = reactive<UserQuery>({
keyword: '',
page: 1,
pageSize: 20
})
async function loadUsers() {
loading.value = true
try {
const result = await getUsers(query)
users.value = result.items
total.value = result.total
} finally {
loading.value = false
}
}
async function search() {
query.page = 1
await loadUsers()
}
onMounted(async () => {
roles.value = await getRoles()
await loadUsers()
})
</script>预期结果
text
进入页面后先获得角色选项,再显示第 1 页用户列表;修改关键字并执行查询时,页码重置为 1,表格进入 loading 状态并在请求完成后刷新。实际接口地址、分页字段和返回结构以项目后端契约为准。
复用同一个表单完成新增与编辑
新增和编辑的字段高度相似,适合共用一个弹窗表单。关键是打开编辑时复制数据,而不是把表格行对象直接交给表单修改,否则用户点击取消也可能污染列表中的原数据。
ts
import { reactive, ref } from 'vue'
import type { UserForm, UserItem } from './types'
import { createUser, updateUser } from './user-api'
const dialogVisible = ref(false)
const form = reactive<UserForm>({
username: '',
displayName: '',
roleIds: []
})
function openCreate() {
Object.assign(form, {
id: undefined,
username: '',
displayName: '',
roleIds: []
})
dialogVisible.value = true
}
function openEdit(row: UserItem) {
Object.assign(form, {
id: row.id,
username: row.username,
displayName: row.displayName,
roleIds: [...row.roleIds]
})
dialogVisible.value = true
}
async function submitForm() {
if (form.id) {
await updateUser(form.id, form)
} else {
await createUser(form)
}
dialogVisible.value = false
await loadUsers()
}预期结果
text
点击新增时得到空表单;点击编辑时回填当前用户数据;提交成功后关闭弹窗并重新查询列表,取消编辑不会改动原表格行。如果用户名由后端规定不可修改,应在编辑态禁用该字段,并让更新接口只提交允许变化的数据。
处理状态变更与角色分配
启停账号和分配角色都是小范围写操作,不需要把整份用户对象重新提交。使用面向意图的接口可以减少误覆盖,也让权限审计更清晰。
ts
import { setUserEnabled, setUserRoles } from './user-api'
async function changeEnabled(row: UserItem, enabled: boolean) {
await setUserEnabled(row.id, enabled)
await loadUsers()
}
async function assignRoles(row: UserItem, roleIds: number[]) {
await setUserRoles(row.id, { roleIds })
await loadUsers()
}预期结果
text
状态切换成功后列表中的 enabled 与服务器一致;角色分配成功后重新查询用户,roleIds 显示为最新角色集合。把页面验收落到可观察结果
完成后至少验证四条主路径:查询条件能正确影响列表;新增和编辑后刷新仍能看到结果;启停账号后重新进入页面状态不丢失;角色分配后再次查询能拿到最新角色。只要所有写操作都以服务器响应为准,并统一回到列表刷新,页面就不会依赖临时前端状态维持正确性。
按自己的节奏,确认真正理解。