论坛 › 鸿蒙 › HarmonyOS实战开辟：@ohos.promptAction （弹窗）

嚴華 发表于 2024-9-13 00:02:35

HarmonyOS实战开辟：@ohos.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 实行上下文。 示例：
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}`);
};
https://img-blog.csdnimg.cn/img_convert/ccba85d00960605be78a907ab833c188.gif
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}`);
};
https://img-blog.csdnimg.cn/img_convert/a31178dc44b94ec6fd4911377d5ec09f.gif
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}`);
};
https://img-blog.csdnimg.cn/img_convert/a31178dc44b94ec6fd4911377d5ec09f.gif
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}`);
};
https://img-blog.csdnimg.cn/img_convert/ff859a21e1b45ba8e1ad703572d0c78f.gif
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}`);
};
https://img-blog.csdnimg.cn/img_convert/ff859a21e1b45ba8e1ad703572d0c78f.gif
操纵菜单选项

操纵菜单的选项。
体系本领：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）最新学习路线

https://img-blog.csdnimg.cn/direct/309a2ac95b5d40aa8c0f79885edb295a.png


[*]  HarmonOS底子技能
https://img-blog.csdnimg.cn/direct/72fd2509a44e4bf98bbe1f983b5a4ff6.png


[*]HarmonOS就业必备技能 https://img-blog.csdnimg.cn/direct/18f024bc5f0a4353912996010ed6cc81.png
[*] HarmonOS多媒体技能
https://img-blog.csdnimg.cn/direct/b9ead66dadc245fdadce4d77feb47a28.png


[*]鸿蒙NaPi组件进阶
https://img-blog.csdnimg.cn/direct/0744fbd1454f41b0a3f605fb4a51f5f3.png


[*]HarmonOS高级技能
https://img-blog.csdnimg.cn/direct/743b668910224b259a5ffe804fa6d0db.png


[*]初识HarmonOS内核 https://img-blog.csdnimg.cn/direct/9e79fbdc4bb74f179584c5552aa547d5.png
[*]实战就业级装备开辟
https://img-blog.csdnimg.cn/direct/d2012fa9c57a400da25a2182a38cbdcb.png
有了路线图，怎么能没有学习资料呢，小编也准备了一份联合鸿蒙官方发布笔记整理收纳的一套体系性的鸿蒙（OpenHarmony ）学习手册（共计1236页）与鸿蒙（OpenHarmony ）开辟入门讲授视频，内容包含：ArkTS、ArkUI、Web开辟、应用模子、资源分类…等知识点。
获取以上完备版高清学习路线，请点击→纯血版全套鸿蒙HarmonyOS学习资料
《鸿蒙 (OpenHarmony)开辟入门讲授视频》

https://img-blog.csdnimg.cn/direct/ad3cb3acb77e470fa93ac0471d4e7f0f.png
《鸿蒙生态应用开辟V2.0白皮书》

https://img-blog.csdnimg.cn/img_convert/bf439a395d3ce8e8cf3dee8e8b75e3a9.jpeg
《鸿蒙 (OpenHarmony)开辟底子到实战手册》

OpenHarmony北向、南向开辟情况搭建
https://img-blog.csdnimg.cn/img_convert/aff76dc1c3c84c360a9ff825908b2e98.png
 《鸿蒙开辟底子》



[*]ArkTS语言
[*]安装DevEco Studio
[*]运用你的第一个ArkTS应用
[*]ArkUI声明式UI开辟
[*].……
https://img-blog.csdnimg.cn/img_convert/2b8f290e39e52efb0a5709be96ff82ea.png
 《鸿蒙开辟进阶》



[*]Stage模子入门
[*]网络管理
[*]数据管理
[*]电话服务
[*]分布式应用开辟
[*]通知与窗口管理
[*]多媒体技能
[*]安全技能
[*]使命管理
[*]WebGL
[*]国际化开辟
[*]应用测试
[*]DFX面向未来计划
[*]鸿蒙体系移植和裁剪定制
[*]……
https://img-blog.csdnimg.cn/img_convert/06651107041ecdf7d26caed596ac4302.png
《鸿蒙进阶实战》



[*]ArkTS实践
[*]UIAbility应用
[*]网络案例
[*]……
https://img-blog.csdnimg.cn/img_convert/42bc7f572540ddbbd4d38e5bf3148fce.png
 获取以上完备鸿蒙HarmonyOS学习资料，请点击→纯血版全套鸿蒙HarmonyOS学习资料
总结

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

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。

查看完整版本: HarmonyOS实战开辟：@ohos.promptAction （弹窗）