HarmonyOS API:@ohos.promptAction (弹窗)

joytrian
发布于 2023-4-4 15:43
浏览
0收藏

版本:v3.1 Beta

@ohos.promptAction (弹窗)

更新时间: 2023-02-17 09:19


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


说明

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

导入模块

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}`);
};

HarmonyOS API:@ohos.promptAction (弹窗)-鸿蒙开发者社区

ShowToastOptions

文本提示框的选项。

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

名称

类型

必填

说明

message

string| ​​Resource​9+

显示的文本信息。

duration

number

默认值1500ms,取值区间:1500ms-10000ms。若小于1500ms则取默认值,若大于10000ms则取上限值10000ms。

bottom

string| number

设置弹窗边框距离屏幕底部的位置。

promptAction.showDialog

showDialog(options: ShowDialogOptions): Promise<ShowDialogSuccessResponse>

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

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

参数:

参数名

类型

必填

说明

options

​ShowDialogOptions​

对话框选项。

返回值:

类型

说明

Promise<​​ShowDialogSuccessResponse​​>

对话框响应结果。

错误码:

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

错误码ID

错误信息

100001

if UI execution context not found.

示例:

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 => {
      console.info('showDialog error: ' + err);
    })
} catch (error) {
  console.error(`showDialog args error code is ${error.code}, message is ${error.message}`);
};

HarmonyOS API:@ohos.promptAction (弹窗)-鸿蒙开发者社区

promptAction.showDialog

showDialog(options: ShowDialogOptions, callback: AsyncCallback<ShowDialogSuccessResponse>):void

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

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

参数:

参数名

类型

必填

说明

options

​ShowDialogOptions​

页面显示对话框信息描述。

callback

AsyncCallback<​​ShowDialogSuccessResponse​​>

对话框响应结果回调。

错误码:

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

错误码ID

错误信息

100001

if UI execution context not found.

示例:

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) {
  console.error(`showDialog args error code is ${error.code}, message is ${error.message}`);
};

HarmonyOS API:@ohos.promptAction (弹窗)-鸿蒙开发者社区

ShowDialogOptions

对话框的选项。

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

名称

类型

必填

说明

title

string| ​​Resource​9+

标题文本。

message

string| ​​Resource​9+

内容文本。

buttons

[​​Button​​​,​​Button​​​?,​​Button​​?]

对话框中按钮的数组,结构为:{text:'button', color: '#666666'},支持1-3个按钮。其中第一个为positiveButton;第二个为negativeButton;第三个为neutralButton。

ShowDialogSuccessResponse

对话框的响应结果。

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

名称

类型

必填

说明

index

number

选中按钮在buttons数组中的索引。

promptAction.showActionMenu

showActionMenu(options: ActionMenuOptions, callback: AsyncCallback<ActionMenuSuccessResponse>):void

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

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

参数:

参数名

类型

必填

说明

options

​ActionMenuOptions​

操作菜单选项。

callback

AsyncCallback<​​ActionMenuSuccessResponse​​>

菜单响应结果回调。

错误码:

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

错误码ID

错误信息

100001

if UI execution context not found.

示例:

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) {
  console.error(`showActionMenu args error code is ${error.code}, message is ${error.message}`);
};

HarmonyOS API:@ohos.promptAction (弹窗)-鸿蒙开发者社区

promptAction.showActionMenu

showActionMenu(options: ActionMenuOptions): Promise<ActionMenuSuccessResponse>

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

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

参数:

参数名

类型

必填

说明

options

​ActionMenuOptions​

操作菜单选项。

返回值:

类型

说明

Promise<​​ActionMenuSuccessResponse​​>

菜单响应结果。

错误码:

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

错误码ID

错误信息

100001

if UI execution context not found.

示例:

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 => {
      console.info('showActionMenu error: ' + err);
    })
} catch (error) {
  console.error(`showActionMenu args error code is ${error.code}, message is ${error.message}`);
};

HarmonyOS API:@ohos.promptAction (弹窗)-鸿蒙开发者社区

ActionMenuOptions

操作菜单的选项。

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

名称

类型

必填

说明

title

string| ​​Resource​9+

标题文本。

buttons

[​​Button​​​,​​Button​​​?,​​Button​​​?,​​Button​​​?,​​Button​​​?,​​Button​​?]

菜单中菜单项按钮的数组,结构为:{text:'button', color: '#666666'},支持1-6个按钮。大于6个按钮时弹窗不显示。

ActionMenuSuccessResponse

操作菜单的响应结果。

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

名称

类型

必填

说明

index

number

选中按钮在buttons数组中的索引,从0开始。

Button

菜单中的菜单项按钮。

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

名称

类型

必填

说明

text

string| ​​Resource​9+

按钮文本内容。

color

string| ​​Resource​9+

按钮文本颜色。


文章转载自:​​https://developer.harmonyos.com/cn/docs/documentation/doc-references-V3/js-apis-promptaction-0000001478341345-V3?catalogVersion=V3​

分类
已于2023-4-4 15:43:08修改
收藏
回复
举报
回复