# 鸿蒙三方库 | harmony-utils之ToastUtil吐司提示详解

前言Toast提示是轻量级的信息反馈方式短暂显示后自动消失不打断用户操作。pura/harmony-utils的ToastUtil封装了Toast显示方法支持不同时长和位置。本文将从API说明、代码实战、进阶用法、常见问题等多个维度进行全面讲解帮助开发者快速掌握并应用到实际项目中。一、ToastUtil核心APIToastUtil提供了以下Toast显示方法方法说明参数使用场景show(message)显示短时Toastmessage操作反馈showLong(message)显示长时Toastmessage较长提示showAtBottom(message)底部显示Toastmessage底部提示showAtCenter(message)居中显示Toastmessage居中提示1.1 核心特性简洁易用封装复杂API为一行调用降低使用门槛类型安全完整的TypeScript类型定义编译期即可发现错误异常处理内置异常捕获机制避免运行时崩溃灵活定位支持不同位置和时长1.2 Toast与Dialog对比特性ToastDialog打断性不打断操作阻断操作显示时长自动消失需手动关闭交互性无有按钮适用场景轻量反馈重要确认二、完整使用步骤2.1 安装依赖ohpminstallpura/harmony-utils2.2 基本Toastimport{ToastUtil}frompura/harmony-utils;Button(显示短Toast).width(100%).onClick((){try{ToastUtil.show(操作成功);this.result短Toast已显示 ;}catch(e){this.result异常: e;}})Button(显示长Toast).width(100%).onClick((){try{ToastUtil.showLong(这是一条较长的提示信息会显示更久);this.result长Toast已显示 ;}catch(e){this.result异常: e;}})2.3 不同位置ToastButton(底部Toast).width(100%).onClick((){ToastUtil.showAtBottom(底部提示);this.result底部Toast已显示;})Button(居中Toast).width(100%).onClick((){ToastUtil.showAtCenter(居中提示);this.result居中Toast已显示;})三、完整页面示例import{ToastUtil}frompura/harmony-utils;EntryComponentstruct ToastDemo{Stateresult:string;build(){Column({space:12}){Button(短Toast).width(100%).onClick((){ToastUtil.show(操作成功);this.result短Toast已显示;});Button(长Toast).width(100%).onClick((){ToastUtil.showLong(这是一条较长的提示信息);this.result长Toast已显示;});Button(底部Toast).width(100%).onClick((){ToastUtil.showAtBottom(底部提示);});Text(this.result).fontSize(14).fontColor(#333333)}.padding(16)}}四、进阶用法4.1 操作反馈封装import{ToastUtil}frompura/harmony-utils;functionshowSuccess(message:string):void{ToastUtil.showAtCenter(✅${message});}functionshowError(message:string):void{ToastUtil.showAtCenter(❌${message});}functionshowWarning(message:string):void{ToastUtil.showAtCenter(⚠️${message});}4.2 网络状态提示NetworkUtil.onNetworkChange((){if(NetworkUtil.isNetworkAvailable()){ToastUtil.show(网络已恢复);}else{ToastUtil.showLong(网络已断开请检查网络设置);}});五、注意事项频率控制避免短时间内频繁显示Toast内容长度Toast内容应简洁不宜过长不阻断Toast不会阻断用户操作初始化依赖使用前需确保AppUtil.init()已调用时序问题连续显示Toast时后者可能覆盖前者六、常见问题Q1: Toast显示后立即消失短时Toast约2秒消失如需更久请使用showLong。Q2: 连续调用show只显示最后一个Toast会覆盖前一个建议间隔显示或合并消息。Q3: Toast可以自定义样式吗ToastUtil提供标准样式如需自定义请使用ArkUI的CustomDialog。Q4: Toast在后台能显示吗Toast需要UI上下文应用在后台时无法显示。总结ToastUtil的Toast提示方法为轻量级信息反馈提供了便捷支持。本文详细介绍了核心API、使用步骤、完整示例、进阶用法以及常见问题的解决方案。开发者可以利用Toast实现操作反馈、状态提示等功能。本文基于pura/harmony-utils工具库更多功能请参考官方文档与后续系列文章。