鸿蒙(HarmonyOS)项目方舟框架(ArkUI)之Toast组件
一、操作环境
操作系统: Windows 10 专业版、IDE:DevEco Studio 3.1、SDK:HarmonyOS 3.1
二、Toast组件
Toast 的应用场景也非常广泛,比如网络请求出错了可以弹一个 Toast 提示等。@ohos.prompt
模块里提供显示一个 Toast 的 API 如下所示:
declare namespace prompt {// 显示一个Toastfunction showToast(options: ShowToastOptions):void;
}interface ShowToastOptions { // Toast配置参数message: string; // Toast显示文本duration?: number; // Toast显示时长bottom?: string | number; // Toast距离屏幕底部距离
}
- options:设备 Toast 显示特性,
ShowToastOptions
参数说明如下:- message:提示文本,必填项。
- duration:Toast 显示时间,单位毫秒,范围 [1500, 10000],默认1500。
- bottom:设置 Toast 的显示位置距离底部的间距。
三、示例
代码
import prompt from '@ohos.prompt';@Entry @Component struct ToastTest {build() {Column({space: 10}) {Button("无参数Toast").onClick(() => {prompt.showToast({message: "默认Toast"})})Button("带参数Toast").onClick(() => {prompt.showToast({message: "bottom为300的位置", // 显示文本duration: 8000, // 显示时长bottom: 300 // 距离底部的距离})})}.width('100%').height('100%').padding(10)}
}
图片