赞
踩
创建并显示文本提示框、对话框和操作菜单。
说明:
本模块首批接口从API version 9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
该模块不支持在UIAbility的文件声明处使用,即不能在UIAbility的生命周期中调用,需要在创建组件实例后使用。
本模块功能依赖UI的执行上下文,不可在UI上下文不明确的地方使用,参见UIContext说明。
从API version 10开始,可以通过使用UIContext中的getPromptAction方法获取当前UI上下文关联的PromptAction对象。
import promptAction from '@ohos.promptAction';
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}`);
- };
文本提示框的选项。
系统能力:SystemCapability.ArkUI.ArkUI.Full。
名称 | 类型 | 必填 | 说明 |
---|---|---|---|
消息 | 字符串|资源9+ | 是 | 显示的文本信息。 说明: 默认字体为'Harmony Sans',不支持设置其他字体。 |
期间 | 数 | 否 | 默认值1500ms,取值区间:1500ms-10000ms。若小于1500ms则取默认值,若大于10000ms则取上限值10000ms。 |
底 | 字符串|数 | 否 | 设置弹窗边框距离屏幕底部的位置。 默认值:80vp |
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}`);
- };
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}`);
- };
对话框的选项。
系统能力: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%' } |
对话框的响应结果。
系统能力:SystemCapability.ArkUI.ArkUI.Full
名称 | 类型 | 必填 | 说明 |
---|---|---|---|
指数 | 数 | 否 | 选中按钮在buttons数组中的索引。 |
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}`);
- };
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}`);
- };
操作菜单的选项。
系统能力:SystemCapability.ArkUI.ArkUI.Full。
名称 | 类型 | 必填 | 说明 |
---|---|---|---|
标题 | 字符串|资源9+ | 否 | 标题文本。 |
按钮 | [按钮,按钮?,按钮?,按钮?,按钮?,按钮?] | 是 | 菜单中菜单项按钮的数组,结构为:{text:'button', color: '#666666'},支持1-6个按钮。按钮数量大于6个时,仅显示前6个按钮,之后的按钮不显示。 |
操作菜单的响应结果。
系统能力:SystemCapability.ArkUI.ArkUI.Full
名称 | 类型 | 必填 | 说明 |
---|---|---|---|
指数 | 数 | 否 | 选中按钮在buttons数组中的索引,从0开始。 |
菜单中的菜单项按钮。
系统能力:SystemCapability.ArkUI.ArkUI.Full
有很多小伙伴不知道学习哪些鸿蒙开发技术?不知道需要重点掌握哪些鸿蒙应用开发知识点?而且学习时频繁踩坑,最终浪费大量时间。所以有一份实用的鸿蒙(HarmonyOS NEXT)资料用来跟着学习是非常有必要的。
这份鸿蒙(HarmonyOS NEXT)资料包含了鸿蒙开发必掌握的核心知识要点,内容包含了(ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战等等)鸿蒙(HarmonyOS NEXT)技术知识点。
希望这一份鸿蒙学习资料能够给大家带来帮助,有需要的小伙伴自行领取,限时开源,先到先得~无套路领取!!
获取这份完整版高清学习路线,请点击→纯血版全套鸿蒙HarmonyOS学习资料
HarmonOS基础技能
有了路线图,怎么能没有学习资料呢,小编也准备了一份联合鸿蒙官方发布笔记整理收纳的一套系统性的鸿蒙(OpenHarmony )学习手册(共计1236页)与鸿蒙(OpenHarmony )开发入门教学视频,内容包含:ArkTS、ArkUI、Web开发、应用模型、资源分类…等知识点。
获取以上完整版高清学习路线,请点击→纯血版全套鸿蒙HarmonyOS学习资料
OpenHarmony北向、南向开发环境搭建
获取以上完整鸿蒙HarmonyOS学习资料,请点击→纯血版全套鸿蒙HarmonyOS学习资料
总的来说,华为鸿蒙不再兼容安卓,对中年程序员来说是一个挑战,也是一个机会。只有积极应对变化,不断学习和提升自己,他们才能在这个变革的时代中立于不败之地。
Copyright © 2003-2013 www.wpsshop.cn 版权所有,并保留所有权利。