Vue / 系统课时

实现用户列表查询

实现用户列表查询

本课完成用户列表的最小查询闭环:定义查询参数与响应结构,统一首次加载、条件查询和重置操作,并让加载中、请求失败、结果为空三种状态都有明确反馈。

学习目标

  • 建立类型明确的用户查询参数和列表响应模型
  • 用一个加载函数统一首次加载、条件查询与重置查询
  • 正确呈现加载、错误、空数据和正常列表状态

先约定查询模型

列表页至少需要维护查询条件、表格数据和请求状态。查询条件只保存用户可编辑的字段,不要把 loading、错误信息等界面状态混入接口参数,否则重置表单时容易误改页面状态。

下面是接口层片段示例,依赖项目已有的 @/utils/request 请求实例。后端字段名不同时,只调整接口层映射,不要让页面组件直接适配多种返回格式。

ts
import request from '@/utils/request'

export interface UserQuery {
  keyword: string
  status: '' | 'enabled' | 'disabled'
}

export interface UserRow {
  id: number
  username: string
  nickname: string
  status: 'enabled' | 'disabled'
}

export interface UserListResponse {
  list: UserRow[]
  total: number
}

export function queryUsers(params: UserQuery) {
  return request.get<UserListResponse>('/users', { params })
}

该接口生效后,请求会把 keyword 和 status 放入查询字符串,并把响应约束为 list 与 total。可在浏览器网络面板中确认请求参数和响应字段是否一致。

统一列表加载流程

首次进入页面、点击查询和重置条件都应调用同一个 loadUsers。这样加载状态、异常处理和数据赋值只维护一份,避免不同入口出现行为差异。

用户列表查询状态流转

下面是页面核心片段,依赖 Element Plus 和前面的 queryUsers。它把所有请求入口收敛到一个函数,并在失败时清空旧数据,避免用户误把上一次结果当成当前结果。

vue
<script setup lang="ts">
import { onMounted, reactive, ref } from 'vue'
import { queryUsers, type UserRow } from '@/api/user'

const query = reactive({
  keyword: '',
  status: '' as '' | 'enabled' | 'disabled'
})

const rows = ref<UserRow[]>([])
const total = ref(0)
const loading = ref(false)
const errorMessage = ref('')

async function loadUsers() {
  loading.value = true
  errorMessage.value = ''

  try {
    const { data } = await queryUsers({ ...query })
    rows.value = data.list
    total.value = data.total
  } catch {
    rows.value = []
    total.value = 0
    errorMessage.value = '用户列表加载失败,请稍后重试'
  } finally {
    loading.value = false
  }
}

function handleSearch() {
  loadUsers()
}

function handleReset() {
  query.keyword = ''
  query.status = ''
  loadUsers()
}

onMounted(loadUsers)
</script>

<template>
  <el-alert
    v-if="errorMessage"
    :title="errorMessage"
    type="error"
    show-icon
    :closable="false"
  />

  <el-form :model="query" inline>
    <el-form-item label="关键词">
      <el-input v-model.trim="query.keyword" clearable placeholder="用户名或昵称" />
    </el-form-item>
    <el-form-item label="状态">
      <el-select v-model="query.status" clearable placeholder="全部状态">
        <el-option label="启用" value="enabled" />
        <el-option label="禁用" value="disabled" />
      </el-select>
    </el-form-item>
    <el-form-item>
      <el-button type="primary" @click="handleSearch">查询</el-button>
      <el-button @click="handleReset">重置</el-button>
    </el-form-item>
  </el-form>

  <el-table v-loading="loading" :data="rows" row-key="id">
    <el-table-column prop="username" label="用户名" />
    <el-table-column prop="nickname" label="昵称" />
    <el-table-column prop="status" label="状态" />
    <template #empty>
      <el-empty description="暂无符合条件的用户" />
    </template>
  </el-table>

  <p>共 {{ total }} 条</p>
</template>

预期结果

text
首次进入:自动请求 /users,并显示加载状态。
条件查询:请求携带当前 keyword 与 status,表格替换为新结果。
空结果:表格区域显示“暂无符合条件的用户”。
请求失败:旧数据被清空,并显示错误提示。

处理查询边界

关键词输入使用 v-model.trim,可避免首尾空格导致无效筛选。状态值使用固定联合类型,防止页面提交后端不认识的字符串。不要在 catch 中只弹消息而保留旧列表,否则界面会同时表达“请求失败”和“数据有效”两种冲突状态。

快速连续点击查询时,可能发生后发请求先返回的问题。接口响应较慢时,可进一步使用取消请求或请求序号,只接收最后一次查询结果;本课先保证基础闭环正确,再按实际并发情况增强。

验收列表查询

依次验证首次进入、输入关键词、切换状态、重置条件、查询空结果和模拟接口失败。网络面板中的参数应与表单一致;每次请求结束后加载遮罩都必须关闭;失败后不应继续显示旧数据。

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

目录与阅读设置

阅读设置

17

记录一个想法

实现用户列表查询

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

登录哪都通