61 lines
2.0 KiB
TypeScript
61 lines
2.0 KiB
TypeScript
/**
|
||
* 反馈语义模型(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
|
||
}
|