Vue / 系统课时

建立反馈组件

建立反馈组件

管理后台中的成功提示、删除确认、页面加载和空结果若各自随意实现,会出现文案、时机和交互行为不一致。本课建立一层统一反馈服务,并给出选择规则,让业务代码只描述“发生了什么”,不再重复配置具体组件。

学习目标

  • 区分消息提示、操作确认、加载遮罩和结果状态
  • 封装统一反馈服务并减少重复配置
  • 避免提示滥用、遮罩泄漏和重复确认

先确定反馈类型

四类反馈解决的问题不同:消息提示用于短暂结果,操作确认用于不可逆或高风险动作,加载遮罩用于阻止重复操作,结果状态用于页面没有数据、加载失败或权限不足时持续展示。

类型 适用场景 是否阻断操作 推荐持续时间
消息提示 保存成功、复制完成、轻量失败 否 2~4 秒
操作确认 删除、停用、覆盖、批量变更 是 直到用户选择
加载遮罩 页面首屏加载、长耗时提交 视范围而定 请求结束
结果状态 空数据、请求失败、无权限 否 状态改变前

不要同时使用多种反馈表达同一个结果。例如保存成功后,按钮状态恢复并显示一条成功消息即可,不需要再弹出成功对话框。删除操作则应先确认,完成后再给简短结果提示。

管理后台反馈类型选择流程

封装统一反馈服务

下面以 Element Plus 为例建立 feedback.ts。业务代码只调用语义化方法,默认文案、显示时长和确认按钮样式集中维护。这样更换 UI 库或调整交互规则时,不必逐页修改。

ts
import {
  ElLoading,
  ElMessage,
  ElMessageBox,
  type LoadingInstance
} from 'element-plus'

type ConfirmOptions = {
  title?: string
  confirmText?: string
  cancelText?: string
}

export const feedback = {
  success(message: string) {
    ElMessage({ type: 'success', message, duration: 2500 })
  },

  error(message = '操作失败,请稍后重试') {
    ElMessage({ type: 'error', message, duration: 4000, showClose: true })
  },

  async confirmDanger(
    message: string,
    options: ConfirmOptions = {}
  ): Promise<boolean> {
    try {
      await ElMessageBox.confirm(message, options.title ?? '请确认', {
        type: 'warning',
        confirmButtonText: options.confirmText ?? '确认',
        cancelButtonText: options.cancelText ?? '取消',
        confirmButtonClass: 'el-button--danger',
        closeOnClickModal: false
      })
      return true
    } catch {
      return false
    }
  },

  loading(text = '处理中...'): LoadingInstance {
    return ElLoading.service({
      lock: true,
      text,
      background: 'rgba(255, 255, 255, 0.72)'
    })
  }
}

生效行为:success 和 error 产生统一消息提示;confirmDanger 把用户选择转换为布尔值;loading 返回可关闭实例。可在任意业务模块中导入,不需要重复填写按钮文案和显示时长。

在删除操作中组合使用

高风险操作的推荐顺序是“确认、加载、请求、结果、关闭加载”。加载实例必须在 finally 中关闭,避免请求异常后遮罩永久停留。

ts
import { feedback } from '@/utils/feedback'

export async function removeUser(id: number): Promise<void> {
  const confirmed = await feedback.confirmDanger(
    '删除后无法恢复,是否继续?',
    { title: '删除用户', confirmText: '删除' }
  )
  if (!confirmed) return

  const loading = feedback.loading('正在删除...')
  try {
    const response = await fetch(`/api/users/${id}`, {
      method: 'DELETE'
    })

    if (!response.ok) {
      throw new Error(`HTTP ${response.status}`)
    }

    feedback.success('删除成功')
  } catch (error) {
    console.error(error)
    feedback.error('删除失败,请检查网络后重试')
  } finally {
    loading.close()
  }
}

预期输出

text
用户取消:不发送请求,也不显示结果消息。
删除成功:关闭遮罩并显示“删除成功”。
删除失败:关闭遮罩并显示“删除失败,请检查网络后重试”。

实际请求路径中的用户编号为 /api/users/<ID>,服务端状态码和错误体可能因接口实现不同而变化。

页面结果状态要留在布局中

消息提示适合短暂反馈,但空数据、加载失败和无权限需要持续可见。页面组件应根据状态渲染对应内容,而不是只弹一条消息后留下空白页面。

vue
<script setup lang="ts">
defineProps<{
  loading: boolean
  error: string
  empty: boolean
}>()

defineEmits<{
  retry: []
}>()
</script>

<template>
  <el-skeleton v-if="loading" :rows="6" animated />
  <el-result
    v-else-if="error"
    icon="error"
    title="加载失败"
    :sub-title="error"
  >
    <template #extra>
      <el-button type="primary" @click="$emit('retry')">重新加载</el-button>
    </template>
  </el-result>
  <el-empty v-else-if="empty" description="暂无数据" />
  <slot v-else />
</template>

预期结果:加载中显示骨架屏;请求失败时保留错误说明和重试按钮;数据为空时显示空状态;只有数据正常时才渲染业务内容。

使用边界与检查项

全局遮罩只用于需要锁定整个页面的操作,局部表格刷新应使用表格自身的 loading,否则用户无法操作无关区域。连续批量操作可以合并为一次结果提示,避免消息堆叠。

错误提示应告诉用户下一步能做什么,例如“请检查网络后重试”,而不是只显示内部异常文本。后端返回的堆栈、SQL 或敏感字段不得直接展示给用户,可记录到日志供排查。

确认框只用于真正存在损失或不可逆后果的操作。普通保存、查询和分页不需要确认,否则会增加无意义的点击成本。

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

目录与阅读设置

阅读设置

17

记录一个想法

建立反馈组件

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

登录哪都通