$tip Toast 统一调用 Skill
本 Skill 用于当用户提出“提示/Toast 怎么写”、“$tip 怎么用”、“复制成功要不要提示”等需求时。
同时:在你编写代码时,只要你想到需要向用户展示一个提示(成功/失败/警告/信息),也要优先按本 Skill 的规范调用 $tip。
统一调用规则
- 使用前必须先写:
const { $tip } = useNuxtApp();
- 调用签名:
$tip(message, { color: string, icon: string, timeout: number })
- 成功默认规则:
- 只要写:
$tip(message) - 默认
color: 'success' - 默认
icon: 'mdi-check'(对勾) - 默认
timeout: 3000
- 只要写:
timeout: -1代表永久不自动关闭:- 需要用户自己手动关闭(Snackbar 右上角关闭按钮)
- 示例:
$tip('长期提示', { timeout: -1 })
- 错误规则(必须手动):
- 当你要表达错误时,必须手动传:
$tip(message, { color: 'error', icon: 'mdi-error' })
示例
成功提示:
const { $tip } = useNuxtApp();$tip('操作成功');
错误提示(必须指定 icon):
const { $tip } = useNuxtApp();$tip('保存失败', { color: 'error', icon: 'mdi-error' });
自定义颜色/超时(非 error 时可不传 icon):
$tip('正在生成报告...', { color: 'info', timeout: 5000 });