Files
crawler-plugin/admin-frontend-vue/src/components/admin-feedback.ts
T

61 lines
2.0 KiB
TypeScript
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
/**
* 反馈语义模型(module 13 task 246):成功/错误/警告统一文案与 busy 防重入。
* 纯逻辑、不依赖 Element;UI 接线见 admin-feedback-ui.ts。
*/
export type AdminFeedbackKind = 'success' | 'error' | 'warning'
export const FEEDBACK_TEXT = {
successDefault: '操作成功',
errorDefault: '操作失败,请稍后重试',
warningDefault: '请确认后再继续',
busySuffix: '中…',
} as const
export interface NormalizedFeedback {
kind: AdminFeedbackKind
message: string
}
const KIND_DEFAULT: Record<AdminFeedbackKind, string> = {
success: FEEDBACK_TEXT.successDefault,
error: FEEDBACK_TEXT.errorDefault,
warning: FEEDBACK_TEXT.warningDefault,
}
/** 归一反饋消息:显式 message 保留并去首尾空白,空值按 kind 落默认文案。 */
export function normalizeFeedback(message?: string, kind?: AdminFeedbackKind): NormalizedFeedback {
const k: AdminFeedbackKind = kind ?? 'warning'
const trimmed = typeof message === 'string' ? message.trim() : ''
return { kind: k, message: trimmed ? trimmed : KIND_DEFAULT[k] }
}
/** 忙碌按钮文案:「保存」→「保存中…」;已以「中」结尾则不重复补。 */
export function busyLabel(verb: string): string {
const v = (verb || '处理').trim()
return v.endsWith('中') ? `${v}…` : `${v}${FEEDBACK_TEXT.busySuffix}`
}
/** 把 Error/字符串/未知错误转成可行动错误文案;空值回默认错误。 */
export function actionableErrorText(error: unknown): string {
if (error instanceof Error && error.message && error.message.trim()) return error.message.trim()
if (typeof error === 'string' && error.trim()) return error.trim()
return FEEDBACK_TEXT.errorDefault
}
// busy 单例锁:表单提交/导出等防重复进入。
let busy = false
export function tryBeginBusy(): boolean {
if (busy) return false
busy = true
return true
}
export function endBusy(): void {
busy = false
}
export function isBusy(): boolean {
return busy
}