当前位置:   article > 正文

HarmonyOS实战开发:@ohos.promptAction (弹窗)

promptaction

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

说明:

本模块首批接口从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 执行上下文。

示例:

  1. import promptAction from '@ohos.promptAction'
  2. import { BusinessError } from '@ohos.base';
  3. try {
  4. promptAction.showToast({
  5. message: 'Message Info',
  6. duration: 2000
  7. });
  8. } catch (error) {
  9. let message = (error as BusinessError).message
  10. let code = (error as BusinessError).code
  11. console.error(`showToast args error code is ${code}, message is ${message}`);
  12. };

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 执行上下文。

示例:

  1. import promptAction from '@ohos.promptAction'
  2. import { BusinessError } from '@ohos.base';
  3. try {
  4. promptAction.showDialog({
  5. title: 'Title Info',
  6. message: 'Message Info',
  7. buttons: [
  8. {
  9. text: 'button1',
  10. color: '#000000'
  11. },
  12. {
  13. text: 'button2',
  14. color: '#000000'
  15. }
  16. ],
  17. })
  18. .then(data => {
  19. console.info('showDialog success, click button: ' + data.index);
  20. })
  21. .catch((err:Error) => {
  22. console.info('showDialog error: ' + err);
  23. })
  24. } catch (error) {
  25. let message = (error as BusinessError).message
  26. let code = (error as BusinessError).code
  27. console.error(`showDialog args error code is ${code}, message is ${message}`);
  28. };

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 执行上下文。

示例:

  1. import promptAction from '@ohos.promptAction';
  2. import { BusinessError } from '@ohos.base';
  3. try {
  4. promptAction.showDialog({
  5. title: 'showDialog Title Info',
  6. message: 'Message Info',
  7. buttons: [
  8. {
  9. text: 'button1',
  10. color: '#000000'
  11. },
  12. {
  13. text: 'button2',
  14. color: '#000000'
  15. }
  16. ]
  17. }, (err, data) => {
  18. if (err) {
  19. console.info('showDialog err: ' + err);
  20. return;
  21. }
  22. console.info('showDialog success callback, click button: ' + data.index);
  23. });
  24. } catch (error) {
  25. let message = (error as BusinessError).message
  26. let code = (error as BusinessError).code
  27. console.error(`showDialog args error code is ${code}, message is ${message}`);
  28. };

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 执行上下文。

示例:

  1. import promptAction from '@ohos.promptAction';
  2. import { BusinessError } from '@ohos.base';
  3. try {
  4. promptAction.showActionMenu({
  5. title: 'Title Info',
  6. buttons: [
  7. {
  8. text: 'item1',
  9. color: '#666666'
  10. },
  11. {
  12. text: 'item2',
  13. color: '#000000'
  14. },
  15. ]
  16. }, (err, data) => {
  17. if (err) {
  18. console.info('showActionMenu err: ' + err);
  19. return;
  20. }
  21. console.info('showActionMenu success callback, click button: ' + data.index);
  22. })
  23. } catch (error) {
  24. let message = (error as BusinessError).message
  25. let code = (error as BusinessError).code
  26. console.error(`showActionMenu args error code is ${code}, message is ${message}`);
  27. };

zh-cn_image_0005

promptAction.showActionMenu

showActionMenu(options: ActionMenuOptions): Promise<ActionMenuSuccessResponse>

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

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

参数:

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

返回值:

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

错误码:

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

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

示例:

  1. import promptAction from '@ohos.promptAction';
  2. import { BusinessError } from '@ohos.base';
  3. try {
  4. promptAction.showActionMenu({
  5. title: 'showActionMenu Title Info',
  6. buttons: [
  7. {
  8. text: 'item1',
  9. color: '#666666'
  10. },
  11. {
  12. text: 'item2',
  13. color: '#000000'
  14. },
  15. ]
  16. })
  17. .then(data => {
  18. console.info('showActionMenu success, click button: ' + data.index);
  19. })
  20. .catch((err:Error) => {
  21. console.info('showActionMenu error: ' + err);
  22. })
  23. } catch (error) {
  24. let message = (error as BusinessError).message
  25. let code = (error as BusinessError).code
  26. console.error(`showActionMenu args error code is ${code}, message is ${message}`);
  27. };

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学习资料

总结

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

声明:本文内容由网友自发贡献,转载请注明出处:【wpsshop博客】
推荐阅读
相关标签
  

闽ICP备14008679号