Vue / 系统课时
建立反馈组件
建立反馈组件
管理后台中的成功提示、删除确认、页面加载和空结果若各自随意实现,会出现文案、时机和交互行为不一致。本课建立一层统一反馈服务,并给出选择规则,让业务代码只描述“发生了什么”,不再重复配置具体组件。
学习目标
- 区分消息提示、操作确认、加载遮罩和结果状态
- 封装统一反馈服务并减少重复配置
- 避免提示滥用、遮罩泄漏和重复确认
先确定反馈类型
四类反馈解决的问题不同:消息提示用于短暂结果,操作确认用于不可逆或高风险动作,加载遮罩用于阻止重复操作,结果状态用于页面没有数据、加载失败或权限不足时持续展示。
| 类型 | 适用场景 | 是否阻断操作 | 推荐持续时间 |
|---|---|---|---|
| 消息提示 | 保存成功、复制完成、轻量失败 | 否 | 2~4 秒 |
| 操作确认 | 删除、停用、覆盖、批量变更 | 是 | 直到用户选择 |
| 加载遮罩 | 页面首屏加载、长耗时提交 | 视范围而定 | 请求结束 |
| 结果状态 | 空数据、请求失败、无权限 | 否 | 状态改变前 |
不要同时使用多种反馈表达同一个结果。例如保存成功后,按钮状态恢复并显示一条成功消息即可,不需要再弹出成功对话框。删除操作则应先确认,完成后再给简短结果提示。

封装统一反馈服务
下面以 Element Plus 为例建立 feedback.ts。业务代码只调用语义化方法,默认文案、显示时长和确认按钮样式集中维护。这样更换 UI 库或调整交互规则时,不必逐页修改。
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 中关闭,避免请求异常后遮罩永久停留。
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()
}
}预期输出
用户取消:不发送请求,也不显示结果消息。
删除成功:关闭遮罩并显示“删除成功”。
删除失败:关闭遮罩并显示“删除失败,请检查网络后重试”。实际请求路径中的用户编号为 /api/users/<ID>,服务端状态码和错误体可能因接口实现不同而变化。
页面结果状态要留在布局中
消息提示适合短暂反馈,但空数据、加载失败和无权限需要持续可见。页面组件应根据状态渲染对应内容,而不是只弹一条消息后留下空白页面。
<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 或敏感字段不得直接展示给用户,可记录到日志供排查。
确认框只用于真正存在损失或不可逆后果的操作。普通保存、查询和分页不需要确认,否则会增加无意义的点击成本。