前言

toast 是 ArkUI 中的轻量提示，在屏幕底部短暂显示文字消息后自动消失。在「猫猫大作战」中，toast 用于操作反馈和提示信息。

一、toast 基础

import { promptAction } from '@kit.ArkUI';

// 显示 toast
promptAction.showToast({
  message: '得分已提交',
  duration: 2000,
});

// 不同场景的 toast
function showMergeToast(): void {
  promptAction.showToast({ message: '🐱 猫咪合并成功！', duration: 1500 });
}

function showSaveToast(): void {
  promptAction.showToast({ message: '✅ 游戏已保存', duration: 2000 });
}

function showErrorToast(err: string): void {
  promptAction.showToast({ message: `❌ 操作失败: ${err}`, duration: 3000 });
}

二、toast 参数

三、游戏中的应用

// 操作反馈
onMerge() {
  promptAction.showToast({ message: '合并成功! +10分', duration: 1000 });
}

onLevelUp() {
  promptAction.showToast({ message: '🎉 升级到中猫！', duration: 2000 });
}

onSaveGame() {
  promptAction.showToast({ message: '已自动保存', duration: 1500 });
}

onNetworkError() {
  promptAction.showToast({ message: '网络异常，请检查连接', duration: 3000 });
}

四、toast vs alertDialog

五、最佳实践

1. 简短消息：不超过 20 字
2. 适中时长：成功 1.5s，错误 3s
3. 非关键信息：toast 不显示错误详情
4. 不滥用：每屏不超过 1 个 toast

总结

toast 显示短暂提示消息，适合操作反馈。核心要点：showToast({ message, duration }) 调用、 成功 1.5s 错误 3s、 非阻塞自动消失。

如果这篇文章对你有帮助，欢迎点赞👍、收藏⭐、关注🔔，你的支持是我持续创作的动力！

相关资源：

• promptAction.showToast API
• 第 93 篇：pause-overlay
• 第 94 篇：alert-dialog
• 第 96 篇：custom-dialog