4、鸿蒙学习-@ohos.promptAction (弹窗)

青春路上的小蜜蜂2024-03-16 10:10

创建并显示文本提示框、对话框和操作菜单。

说明

本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

该模块不支持在UIAbility的文件声明处使用，即不能在UIAbility的生命周期中调用，需要在创建组件实例后使用。

导入模块

import promptAction from '@ohos.promptAction'

promptAction.showToast

showToast(options: ShowToastOptions): void

创建并显示文本提示框。

系统能力： SystemCapability.ArkUI.ArkUI.Full

参数：

参数名	类型	必填	说明
options	ShowToastOptions	是	文本弹窗选项。

错误码：

以下错误码的详细介绍请参见ohos.promptAction(弹窗)错误码。

错误码ID	错误信息
100001	if UI execution context not found.

示例：

try {
  promptAction.showToast({            
    message: 'Message Info',
    duration: 2000,      
  });
} catch (error) {
  console.error(`showToast args error code is ${error.code}, message is ${error.message}`);
};

ShowToastOptions

文本提示框的选项。

系统能力： SystemCapability.ArkUI.ArkUI.Full。

名称	类型	必填	说明
message	string\| Resource9+	是	显示的文本信息。默认字体为'Harmony Sans'，不支持设置其他字体。
duration	number	否	默认值1500ms，取值区间：1500ms-10000ms。若小于1500ms则取默认值，若大于10000ms则取上限值10000ms。
bottom	string\| number	否	设置弹窗边框距离屏幕底部的位置。