鸿蒙（HarmonyOS）项目方舟框架（ArkUI）之Toast组件

一、操作环境

操作系统:  Windows 10 专业版、IDE:DevEco Studio 3.1、SDK:HarmonyOS 3.1

二、Toast组件

Toast 的应用场景也非常广泛，比如网络请求出错了可以弹一个 Toast 提示等。@ohos.prompt 模块里提供显示一个 Toast 的 API 如下所示：

declare namespace prompt {
  // 显示一个Toast
  function 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)
  }
}

图片