Vue / 系统课时
实现批量操作与导出
实现批量操作与导出
批量操作需要同时管理表格选择、确认范围、请求期间锁定和执行后的列表刷新;导出则必须复用当前筛选条件,而不是只导出当前页。本课将把这两条链路整合到用户管理工具栏中,并明确选择数据与筛选数据的边界。
学习目标
- 使用表格选择事件维护稳定的用户 ID 集合
- 完成批量启用、停用、删除及执行后的状态清理
- 按当前筛选条件请求导出文件并触发浏览器下载
区分选择范围与导出范围
批量状态变更和批量删除只作用于用户明确勾选的记录,因此请求参数应使用选中行的 ID 快照。导出通常面向“当前查询结果”,应提交关键词、状态等筛选条件,由后端重新查询全部匹配数据,而不是把当前页的行直接拼成文件。
开始批量请求前要复制一份 ID 数组。这样即使表格刷新、用户取消选择或分页切换,已经发出的请求范围也不会被后续界面变化改写。

实现工具栏与批量请求
下面示例可直接作为 UserBatchTable.vue 使用。项目需要 Element Plus,后端提供列表、批量状态、批量删除和导出接口。示例使用全量列表简化分页细节,但选择快照和导出参数的处理方式可直接用于分页表格。
<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>预期结果
未勾选用户时,三个批量按钮不可点击。
勾选多行后,批量启用、停用或删除会显示包含数量的确认框。
批量请求成功后重新查询列表并清空选择;失败时保留当前列表并显示错误。
点击“按条件导出”后,浏览器下载 users-<TIME>.xlsx,文件内容对应当前关键词和状态筛选结果。<TIME> 表示运行时生成的时间值,实际文件名会不同。若后端通过 Content-Disposition 返回文件名,可优先解析响应头,而不是在前端固定扩展名。
处理分页、部分失败与权限
跨页选择需要先明确产品规则。普通 Element Plus 表格切页后会丢失未保留的选择;若业务要求跨页勾选,应使用稳定的 row-key、保留选择能力,并在独立集合中维护 ID,不能只依赖当前页行对象。
批量接口最好返回成功数、失败数和失败 ID。若服务端允许部分成功,前端不应尝试把所有行整体回滚,而应提示执行摘要并重新加载列表,让服务端最终状态成为唯一事实来源。
导出按钮是否可用通常由导出权限控制,批量删除还应单独校验删除权限。前端隐藏按钮只能改善体验,真正的权限判断必须由后端再次执行。
验收批量操作与导出
验收时先勾选两条记录,分别测试批量状态修改和取消确认;再模拟接口失败,确认选择没有被误清空。批量删除成功后应核对总条数、当前页和空状态是否正确。
导出测试要设置关键词和状态筛选,确认下载文件包含全部匹配数据而非仅当前页。还应测试零结果、超大结果集和重复点击;数据量较大时,后端应改为异步导出任务并返回任务状态,避免请求长时间占用连接。