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 显示为最新角色集合。

把页面验收落到可观察结果

完成后至少验证四条主路径:查询条件能正确影响列表;新增和编辑后刷新仍能看到结果;启停账号后重新进入页面状态不丢失;角色分配后再次查询能拿到最新角色。只要所有写操作都以服务器响应为准,并统一回到列表刷新,页面就不会依赖临时前端状态维持正确性。

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

目录与阅读设置

阅读设置

17

记录一个想法

用户与角色管理

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

登录哪都通