Vue / 系统课时

实现批量操作与导出

实现批量操作与导出

批量操作需要同时管理表格选择、确认范围、请求期间锁定和执行后的列表刷新;导出则必须复用当前筛选条件,而不是只导出当前页。本课将把这两条链路整合到用户管理工具栏中,并明确选择数据与筛选数据的边界。

学习目标

  • 使用表格选择事件维护稳定的用户 ID 集合
  • 完成批量启用、停用、删除及执行后的状态清理
  • 按当前筛选条件请求导出文件并触发浏览器下载

区分选择范围与导出范围

批量状态变更和批量删除只作用于用户明确勾选的记录,因此请求参数应使用选中行的 ID 快照。导出通常面向“当前查询结果”,应提交关键词、状态等筛选条件,由后端重新查询全部匹配数据,而不是把当前页的行直接拼成文件。

开始批量请求前要复制一份 ID 数组。这样即使表格刷新、用户取消选择或分页切换,已经发出的请求范围也不会被后续界面变化改写。

批量操作与筛选导出数据流

实现工具栏与批量请求

下面示例可直接作为 UserBatchTable.vue 使用。项目需要 Element Plus,后端提供列表、批量状态、批量删除和导出接口。示例使用全量列表简化分页细节,但选择快照和导出参数的处理方式可直接用于分页表格。

vue
<script setup lang="ts">
import { computed, onMounted, reactive, ref } from 'vue'
import { ElMessage, ElMessageBox, ElTable } from 'element-plus'

type UserStatus = 'enabled' | 'disabled'

interface UserRow {
  id: number
  username: string
  status: UserStatus
}

const tableRef = ref<InstanceType<typeof ElTable> | null>(null)
const users = ref<UserRow[]>([])
const selectedIds = ref<number[]>([])
const loading = ref(false)
const filters = reactive({
  keyword: '',
  status: '' as '' | UserStatus
})

const hasSelection = computed(() => selectedIds.value.length > 0)

async function request<T>(url: string, options?: RequestInit): Promise<T> {
  const response = await fetch(url, options)
  if (!response.ok) {
    throw new Error(`请求失败:${response.status}`)
  }
  return response.status === 204 ? (undefined as T) : response.json()
}

async function askConfirm(message: string, title: string, danger = false) {
  try {
    await ElMessageBox.confirm(
      message,
      title,
      danger
        ? { type: 'warning', confirmButtonText: '删除', cancelButtonText: '取消' }
        : undefined
    )
    return true
  } catch {
    return false
  }
}

async function loadUsers() {
  const params = new URLSearchParams()
  if (filters.keyword) params.set('keyword', filters.keyword)
  if (filters.status) params.set('status', filters.status)

  users.value = await request<UserRow[]>(`/api/users?${params.toString()}`)
  selectedIds.value = []
  tableRef.value?.clearSelection()
}

function handleSelectionChange(rows: UserRow[]) {
  selectedIds.value = rows.map((row) => row.id)
}

async function batchChangeStatus(status: UserStatus) {
  const ids = [...selectedIds.value]
  const actionText = status === 'enabled' ? '启用' : '停用'
  const confirmed = await askConfirm(
    `确定${actionText}已选择的 ${ids.length} 个用户吗?`,
    '批量确认'
  )
  if (!confirmed) return

  loading.value = true
  try {
    await request<void>('/api/users/batch-status', {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({ ids, status })
    })
    ElMessage.success(`批量${actionText}成功`)
    await loadUsers()
  } catch (error) {
    ElMessage.error(error instanceof Error ? error.message : `批量${actionText}失败`)
  } finally {
    loading.value = false
  }
}

async function batchDelete() {
  const ids = [...selectedIds.value]
  const confirmed = await askConfirm(
    `将永久删除已选择的 ${ids.length} 个用户,是否继续?`,
    '批量删除',
    true
  )
  if (!confirmed) return

  loading.value = true
  try {
    await request<void>('/api/users/batch-delete', {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({ ids })
    })
    ElMessage.success('批量删除成功')
    await loadUsers()
  } catch (error) {
    ElMessage.error(error instanceof Error ? error.message : '批量删除失败')
  } finally {
    loading.value = false
  }
}

async function exportUsers() {
  const params = new URLSearchParams()
  if (filters.keyword) params.set('keyword', filters.keyword)
  if (filters.status) params.set('status', filters.status)

  loading.value = true
  try {
    const response = await fetch(`/api/users/export?${params.toString()}`)
    if (!response.ok) throw new Error(`导出失败:${response.status}`)

    const blob = await response.blob()
    const url = URL.createObjectURL(blob)
    const link = document.createElement('a')
    link.href = url
    link.download = `users-${Date.now()}.xlsx`
    document.body.appendChild(link)
    link.click()
    link.remove()
    URL.revokeObjectURL(url)
    ElMessage.success('导出任务已完成')
  } catch (error) {
    ElMessage.error(error instanceof Error ? error.message : '导出失败')
  } finally {
    loading.value = false
  }
}

onMounted(loadUsers)
</script>

<template>
  <div class="toolbar">
    <el-input v-model="filters.keyword" placeholder="搜索用户名" clearable />
    <el-select v-model="filters.status" placeholder="全部状态" clearable>
      <el-option label="启用" value="enabled" />
      <el-option label="停用" value="disabled" />
    </el-select>
    <el-button :loading="loading" @click="loadUsers">查询</el-button>
    <el-button :disabled="!hasSelection || loading" @click="batchChangeStatus('enabled')">
      批量启用
    </el-button>
    <el-button :disabled="!hasSelection || loading" @click="batchChangeStatus('disabled')">
      批量停用
    </el-button>
    <el-button type="danger" :disabled="!hasSelection || loading" @click="batchDelete">
      批量删除
    </el-button>
    <el-button :loading="loading" @click="exportUsers">按条件导出</el-button>
  </div>

  <el-table
    ref="tableRef"
    v-loading="loading"
    :data="users"
    row-key="id"
    @selection-change="handleSelectionChange"
  >
    <el-table-column type="selection" width="48" />
    <el-table-column prop="username" label="用户名" />
    <el-table-column prop="status" label="状态" />
  </el-table>
</template>

预期结果

text
未勾选用户时,三个批量按钮不可点击。
勾选多行后,批量启用、停用或删除会显示包含数量的确认框。
批量请求成功后重新查询列表并清空选择;失败时保留当前列表并显示错误。
点击“按条件导出”后,浏览器下载 users-<TIME>.xlsx,文件内容对应当前关键词和状态筛选结果。

<TIME> 表示运行时生成的时间值,实际文件名会不同。若后端通过 Content-Disposition 返回文件名,可优先解析响应头,而不是在前端固定扩展名。

处理分页、部分失败与权限

跨页选择需要先明确产品规则。普通 Element Plus 表格切页后会丢失未保留的选择;若业务要求跨页勾选,应使用稳定的 row-key、保留选择能力,并在独立集合中维护 ID,不能只依赖当前页行对象。

批量接口最好返回成功数、失败数和失败 ID。若服务端允许部分成功,前端不应尝试把所有行整体回滚,而应提示执行摘要并重新加载列表,让服务端最终状态成为唯一事实来源。

导出按钮是否可用通常由导出权限控制,批量删除还应单独校验删除权限。前端隐藏按钮只能改善体验,真正的权限判断必须由后端再次执行。

验收批量操作与导出

验收时先勾选两条记录,分别测试批量状态修改和取消确认;再模拟接口失败,确认选择没有被误清空。批量删除成功后应核对总条数、当前页和空状态是否正确。

导出测试要设置关键词和状态筛选,确认下载文件包含全部匹配数据而非仅当前页。还应测试零结果、超大结果集和重复点击;数据量较大时,后端应改为异步导出任务并返回任务状态,避免请求长时间占用连接。

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

目录与阅读设置

阅读设置

17

记录一个想法

实现批量操作与导出

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

登录哪都通