HarmonyOS实战开发：@ohos.promptAction （弹窗）

标签：鸿蒙 promptAction ohos 错误码 HarmonyOS error message ArkUI

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

说明：

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

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

本模块功能依赖UI的执行上下文，不可在UI上下文不明确的地方使用，参见UIContext说明。

从API version 10开始，可以通过使用UIContext中的getPromptAction方法获取当前UI上下文关联的PromptAction对象。

导入模块

import promptAction from '@ohos.promptAction';

promptAction.showToast

showToast（options： ShowToastOptions）： void

创建并显示文本提示框。

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

参数：

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

错误码：

以下错误码的详细介绍，请参见ohos.promptAction（弹窗）错误码。

错误码ID	错误信息
100001	如果未找到 UI 执行上下文。

示例：

import promptAction from '@ohos.promptAction'
import { BusinessError } from '@ohos.base';
try {
  promptAction.showToast({            
    message: 'Message Info',
    duration: 2000 
  });
} catch (error) {
  let message = (error as BusinessError).message
  let code = (error as BusinessError).code
  console.error(`showToast args error code is ${code}, message is ${message}`);
};

ZH-cn_image_0001

ShowToastOptions

文本提示框的选项。

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

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

promptAction.showDialog

showDialog（options： ShowDialogOptions）：Promise<ShowDialogSuccessResponse>

创建并显示对话框，对话框响应后异步返回结果。

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

参数：

参数名	类型	必填	说明
选项	ShowDialogOptions	是	对话框选项。

返回值：

类型	说明
Promise<ShowDialogSuccessResponse>	对话框响应结果。

错误码：

以下错误码的详细介绍，请参见ohos.promptAction（弹窗）错误码。

错误码ID	错误信息
100001	如果未找到 UI 执行上下文。

示例：

import promptAction from '@ohos.promptAction'
import { BusinessError } from '@ohos.base';
try {
  promptAction.showDialog({
    title: 'Title Info',
    message: 'Message Info',
    buttons: [
      {
        text: 'button1',
        color: '#000000'
      },
      {
        text: 'button2',
        color: '#000000'
      }
    ],
  })
    .then(data => {
      console.info('showDialog success, click button: ' + data.index);
    })
    .catch((err:Error) => {
      console.info('showDialog error: ' + err);
    })
} catch (error) {
  let message = (error as BusinessError).message
  let code = (error as BusinessError).code
  console.error(`showDialog args error code is ${code}, message is ${message}`);
};

zh-cn_image_0002

promptAction.showDialog

showDialog（options： ShowDialogOptions， callback： AsyncCallback<ShowDialogSuccessResponse>）：void

创建并显示对话框，对话框响应结果异步返回。

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

参数：

参数名	类型	必填	说明
选项	ShowDialogOptions	是	页面显示对话框信息描述。
回调	AsyncCallback<ShowDialogSuccessResponse>	是	对话框响应结果回调。

错误码：

以下错误码的详细介绍，请参见ohos.promptAction（弹窗）错误码。

错误码ID	错误信息
100001	如果未找到 UI 执行上下文。

示例：

import promptAction from '@ohos.promptAction';
import { BusinessError } from '@ohos.base';
try {
  promptAction.showDialog({
    title: 'showDialog Title Info',
    message: 'Message Info',
    buttons: [
      {
        text: 'button1',
        color: '#000000'
      },
      {
        text: 'button2',
        color: '#000000'
      }
    ]
  }, (err, data) => {
    if (err) {
      console.info('showDialog err: ' + err);
      return;
    }
    console.info('showDialog success callback, click button: ' + data.index);
  });
} catch (error) {
  let message = (error as BusinessError).message
  let code = (error as BusinessError).code
  console.error(`showDialog args error code is ${code}, message is ${message}`);
};

zh-cn_image_0002

ShowDialogOptions

对话框的选项。

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

名称	类型	必填	说明
标题	字符串\|资源9+	否	标题文本。
消息	字符串\|资源9+	否	内容文本。
按钮	数组<按钮>	否	对话框中按钮的数组，结构为：{text：'button'， color： '#666666'}，支持大于1个按钮。
对齐10+	对话框对齐	否	弹窗在竖直方向上的对齐方式。默认值：DialogAlignment.Default
偏移量 10+	抵消	否	弹窗相对alignment所在位置的偏移量。默认值：{ dx： 0 ， dy： 0 }
面具矩形10+	矩形	否	弹窗遮蔽层区域，在遮蔽层区域内的事件不透传，在遮蔽层区域外的事件透传。默认值：{ x： 0， y： 0， width： '100%'， height： '100%' }

ShowDialogSuccessResponse

对话框的响应结果。

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

名称	类型	必填	说明
指数	数	否	选中按钮在buttons数组中的索引。

promptAction.showActionMenu

showActionMenu（options： ActionMenuOptions， callback： AsyncCallback<ActionMenuSuccessResponse>）：void

创建并显示操作菜单，菜单响应结果异步返回。

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

参数：

参数名	类型	必填	说明
选项	操作菜单选项	是	操作菜单选项。
回调	AsyncCallback<ActionMenuSuccessResponse>	是	菜单响应结果回调。

错误码：

以下错误码的详细介绍，请参见ohos.promptAction（弹窗）错误码。

错误码ID	错误信息
100001	如果未找到 UI 执行上下文。

示例：

import promptAction from '@ohos.promptAction';
import { BusinessError } from '@ohos.base';
try {
  promptAction.showActionMenu({
    title: 'Title Info',
    buttons: [
      {
        text: 'item1',
        color: '#666666'
      },
      {
        text: 'item2',
        color: '#000000'
      },
    ]
  }, (err, data) => {
    if (err) {
      console.info('showActionMenu err: ' + err);
      return;
    }
    console.info('showActionMenu success callback, click button: ' + data.index);
  })
} catch (error) {
  let message = (error as BusinessError).message
  let code = (error as BusinessError).code
  console.error(`showActionMenu args error code is ${code}, message is ${message}`);
};

zh-cn_image_0005

promptAction.showActionMenu

showActionMenu（options： ActionMenuOptions）： Promise<ActionMenuSuccessResponse>

创建并显示操作菜单，菜单响应后异步返回结果。

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

参数：

参数名	类型	必填	说明
选项	操作菜单选项	是	操作菜单选项。

返回值：

类型	说明
Promise<ActionMenuSuccessResponse>	菜单响应结果。

错误码：

以下错误码的详细介绍，请参见ohos.promptAction（弹窗）错误码。

错误码ID	错误信息
100001	如果未找到 UI 执行上下文。

示例：

import promptAction from '@ohos.promptAction';
import { BusinessError } from '@ohos.base';
try {
  promptAction.showActionMenu({
    title: 'showActionMenu Title Info',
    buttons: [
      {
        text: 'item1',
        color: '#666666'
      },
      {
        text: 'item2',
        color: '#000000'
      },
    ]
  })
    .then(data => {
      console.info('showActionMenu success, click button: ' + data.index);
    })
    .catch((err:Error) => {
      console.info('showActionMenu error: ' + err);
    })
} catch (error) {
  let message = (error as BusinessError).message
  let code = (error as BusinessError).code
  console.error(`showActionMenu args error code is ${code}, message is ${message}`);
};

zh-cn_image_0005

操作菜单选项

操作菜单的选项。

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

名称	类型	必填	说明
标题	字符串\|资源9+	否	标题文本。
按钮	[按钮，按钮？，按钮？，按钮？，按钮？，按钮？]	是	菜单中菜单项按钮的数组，结构为：{text：'button'， color： '#666666'}，支持1-6个按钮。按钮数量大于6个时，仅显示前6个按钮，之后的按钮不显示。

ActionMenuSuccessResponse

操作菜单的响应结果。

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

名称	类型	必填	说明
指数	数	否	选中按钮在buttons数组中的索引，从0开始。

按钮

菜单中的菜单项按钮。

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

名称	类型	必填	说明
发短信	字符串\|资源9+	是	按钮文本内容。
颜色	字符串\|资源9+	是	按钮文本颜色。

最后

有很多小伙伴不知道学习哪些鸿蒙开发技术？不知道需要重点掌握哪些鸿蒙应用开发知识点？而且学习时频繁踩坑，最终浪费大量时间。所以有一份实用的鸿蒙（HarmonyOS NEXT）资料用来跟着学习是非常有必要的。

这份鸿蒙（HarmonyOS NEXT）资料包含了鸿蒙开发必掌握的核心知识要点，内容包含了（ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战等等）鸿蒙（HarmonyOS NEXT）技术知识点。

希望这一份鸿蒙学习资料能够给大家带来帮助，有需要的小伙伴自行领取，限时开源，先到先得~无套路领取！！

获取这份完整版高清学习路线，请点击→纯血版全套鸿蒙HarmonyOS学习资料

鸿蒙（HarmonyOS NEXT）最新学习路线

HarmonOS基础技能

HarmonOS就业必备技能
HarmonOS多媒体技术

鸿蒙NaPi组件进阶

HarmonOS高级技能

初识HarmonOS内核
实战就业级设备开发

有了路线图，怎么能没有学习资料呢，小编也准备了一份联合鸿蒙官方发布笔记整理收纳的一套系统性的鸿蒙（OpenHarmony ）学习手册（共计1236页）与鸿蒙（OpenHarmony ）开发入门教学视频，内容包含：ArkTS、ArkUI、Web开发、应用模型、资源分类…等知识点。

获取以上完整版高清学习路线，请点击→纯血版全套鸿蒙HarmonyOS学习资料

《鸿蒙 (OpenHarmony)开发入门教学视频》

《鸿蒙生态应用开发V2.0白皮书》

《鸿蒙 (OpenHarmony)开发基础到实战手册》

OpenHarmony北向、南向开发环境搭建

《鸿蒙开发基础》

ArkTS语言
安装DevEco Studio
运用你的第一个ArkTS应用
ArkUI声明式UI开发
.……

《鸿蒙开发进阶》

Stage模型入门
网络管理
数据管理
电话服务
分布式应用开发
通知与窗口管理
多媒体技术
安全技能
任务管理
WebGL
国际化开发
应用测试
DFX面向未来设计
鸿蒙系统移植和裁剪定制
……

《鸿蒙进阶实战》

ArkTS实践
UIAbility应用
网络案例
……

获取以上完整鸿蒙HarmonyOS学习资料，请点击→纯血版全套鸿蒙HarmonyOS学习资料

总结

总的来说，华为鸿蒙不再兼容安卓，对中年程序员来说是一个挑战，也是一个机会。只有积极应对变化，不断学习和提升自己，他们才能在这个变革的时代中立于不败之地。

标签：鸿蒙,promptAction,ohos,错误码,HarmonyOS,error,message,ArkUI
From： https://blog.csdn.net/2401_84194030/article/details/139278980

HarmonyOS实战开发：@ohos.promptAction （弹窗）

导入模块

promptAction.showToast

ShowToastOptions

promptAction.showDialog

promptAction.showDialog

ShowDialogOptions

ShowDialogSuccessResponse

promptAction.showActionMenu

promptAction.showActionMenu

操作菜单选项

ActionMenuSuccessResponse

按钮

最后

鸿蒙（HarmonyOS NEXT）最新学习路线

《鸿蒙 (OpenHarmony)开发入门教学视频》

《鸿蒙生态应用开发V2.0白皮书》

《鸿蒙 (OpenHarmony)开发基础到实战手册》

《鸿蒙开发基础》

《鸿蒙开发进阶》

《鸿蒙进阶实战》

总结

相关文章

赞助商

阅读排行