Vue / 系统课时

处理状态与删除操作

处理状态与删除操作

用户管理中的启用、停用和删除都属于高风险写操作。本课将为表格行加入二次确认、单行加载锁、失败恢复和结果提示,使操作既有明确反馈,也不会因重复点击或请求失败造成界面与服务端状态不一致。

学习目标

  • 为启用、停用和删除操作设计清晰的确认流程
  • 使用行级加载状态阻止重复提交,并在失败时恢复原状态
  • 通过重新加载列表和消息提示验证最终结果

先确定操作边界

启用与停用是可逆状态变更,适合在确认后先更新界面,再向服务端提交;请求失败时恢复旧值。删除通常不可逆,必须在服务端返回成功后再从表格移除,避免“界面已删除、服务端仍存在”的假象。

每一行只允许同时执行一个写操作。可以用用户 ID 组成的集合记录正在处理的行;按钮和开关根据集合状态禁用,从而阻止快速连点产生并发请求。

状态变更与删除操作流程

实现单行状态与删除

下面是可放入 UserTable.vue 的完整示例。它使用 Element Plus 展示表格,通过原生 fetch 调用接口;项目需要已经安装并全局注册 Element Plus,后端提供用户查询、状态更新和删除接口。

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

type UserStatus = 'enabled' | 'disabled'

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

const users = ref<UserRow[]>([])
const rowLoading = reactive(new Set<number>())

async function request<T>(url: string, options?: RequestInit): Promise<T> {
  const response = await fetch(url, {
    headers: { 'Content-Type': 'application/json' },
    ...options
  })

  if (!response.ok) {
    throw new Error(`请求失败:${response.status}`)
  }

  return response.status === 204 ? (undefined as T) : response.json()
}

async function loadUsers() {
  users.value = await request<UserRow[]>('/api/users')
}

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 changeStatus(row: UserRow, nextStatus: UserStatus) {
  const actionText = nextStatus === 'enabled' ? '启用' : '停用'
  const confirmed = await askConfirm(
    `确定要${actionText}用户“${row.username}”吗?`,
    '状态确认'
  )
  if (!confirmed) return

  const previousStatus = row.status
  row.status = nextStatus
  rowLoading.add(row.id)

  try {
    await request(`/api/users/${row.id}/status`, {
      method: 'PATCH',
      body: JSON.stringify({ status: nextStatus })
    })
    ElMessage.success(`${actionText}成功`)
  } catch (error) {
    // 乐观更新失败时恢复旧状态,避免界面与服务端不一致
    row.status = previousStatus
    ElMessage.error(error instanceof Error ? error.message : `${actionText}失败`)
  } finally {
    rowLoading.delete(row.id)
  }
}

async function deleteUser(row: UserRow) {
  const confirmed = await askConfirm(
    `删除后无法恢复,确定删除用户“${row.username}”吗?`,
    '删除确认',
    true
  )
  if (!confirmed) return

  rowLoading.add(row.id)

  try {
    await request<void>(`/api/users/${row.id}`, { method: 'DELETE' })
    // 只在服务端确认成功后修改本地列表
    users.value = users.value.filter((item) => item.id !== row.id)
    ElMessage.success('删除成功')
  } catch (error) {
    ElMessage.error(error instanceof Error ? error.message : '删除失败')
  } finally {
    rowLoading.delete(row.id)
  }
}

onMounted(loadUsers)
</script>

<template>
  <el-table :data="users" row-key="id">
    <el-table-column prop="username" label="用户名" />
    <el-table-column label="状态" width="180">
      <template #default="{ row }">
        <el-switch
          :model-value="row.status === 'enabled'"
          :loading="rowLoading.has(row.id)"
          :disabled="rowLoading.has(row.id)"
          @change="(value: boolean) => changeStatus(row, value ? 'enabled' : 'disabled')"
        />
      </template>
    </el-table-column>
    <el-table-column label="操作" width="120">
      <template #default="{ row }">
        <el-button
          type="danger"
          link
          :loading="rowLoading.has(row.id)"
          :disabled="rowLoading.has(row.id)"
          @click="deleteUser(row)"
        >
          删除
        </el-button>
      </template>
    </el-table-column>
  </el-table>
</template>

预期结果

text
切换状态时先出现确认框;确认后当前行进入加载状态。
状态接口成功:开关保持新状态,并显示“启用成功”或“停用成功”。
状态接口失败:开关恢复原状态,并显示请求错误。
删除接口成功:对应行从表格消失,并显示“删除成功”。

实际接口地址、状态字段和响应结构应以项目后端约定为准。若接口返回统一包装对象,应在 request 中解析业务码,而不是只判断 HTTP 状态码。

处理取消、失败与分页变化

用户关闭确认框时,Element Plus 会让确认 Promise 进入拒绝状态。示例中的 askConfirm 将取消转换为 false,因此取消属于正常交互,不会进入请求流程,也不会显示“操作失败”。

状态变更采用旧值快照进行回滚,但删除不做本地乐观移除。若删除的是当前分页最后一条数据,应在成功后重新请求列表,并在当前页已无数据时把页码减一,否则页面可能停留在空页。

当服务端可能因权限、版本冲突或账号被占用而拒绝操作时,错误提示应优先展示后端可读消息,同时保留统一兜底文案。不要把原始堆栈或数据库错误直接暴露给用户。

验证操作闭环

验证时至少覆盖成功、取消和失败三条路径。可以在浏览器开发者工具中临时阻断接口,确认状态操作会回滚、删除操作会保留原行,并检查同一行的按钮在请求期间无法再次点击。

还要检查删除成功后的总条数、页码和空状态是否正确。若项目使用 Pinia 或查询缓存,列表刷新应通过统一的数据入口完成,避免组件本地数据与全局缓存各自维护一份。

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

目录与阅读设置

阅读设置

17

记录一个想法

处理状态与删除操作

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

登录哪都通