> 文档中心 > HarmonyOS应用开发:UI界面-弹窗prompt

HarmonyOS应用开发:UI界面-弹窗prompt


弹窗

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

导入模块 

import prompt from '@ohos.prompt'

prompt.showToast

showToast(options: ShowToastOptions): void

创建并显示文本提示框

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

参数:

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

示例:

prompt.showToast({message: 'Message Info',    duration: 2000,      });

ShowToastOptions

文本提示框的选项。

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

名称 类型 必填 说明
message string| Resource9+ 显示的文本信息。
duration number 默认值1500ms,取值区间:1500ms-10000ms。若小于1500ms则取默认值,若大于10000ms则取上限值10000ms。
bottom string| number 设置弹窗边框距离屏幕底部的位置。

prompt.showDialog同步

showDialog(options: ShowDialogOptions): Promise

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

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

参数:

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

返回值:

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

示例:

prompt.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);  })

 

prompt.showDialog异步

showDialog(options: ShowDialogOptions, callback: AsyncCallback):void

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

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

参数:

参数名 类型 必填 说明
options ShowDialogOptions 页面显示对话框信息描述。
callback AsyncCallback 对话框响应结果回调。

示例:

prompt.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);});

ShowDialogOptions

对话框的选项。

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

名称 类型 必填 说明
title string| Resource9+ 标题文本。
message string| Resource9+ 内容文本。
buttons Array 对话框中按钮的数组,结构为:{text:‘button’, color: ‘#666666’},支持1-3个按钮。其中第一个为positiveButton;第二个为negativeButton;第三个为neutralButton

ShowDialogSuccessResponse

对话框的响应结果

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

名称 类型 说明
index number 选中按钮在buttons数组中的索引。

prompt.showActionMenu异步

showActionMenu(options: ActionMenuOptions, callback: AsyncCallback):void

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

系统能力: 以下各项对应的系统能力均为SystemCapability.ArkUI.ArkUI.Full。

参数:

参数名 类型 必填 说明
options ActionMenuOptions 操作菜单选项。
callback AsyncCallback 菜单响应结果回调。

示例:

prompt.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);})

prompt.showActionMenu同步

showActionMenu(options: ActionMenuOptions): Promise

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

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

参数:

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

返回值:

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

示例:

prompt.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);  })

ActionMenuOptions

操作菜单的选项。

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

名称 类型 必填 说明
title string| Resource9+ 标题文本。
buttons Array 菜单中菜单项按钮的数组,结构为:{text:‘button’, color: ‘#666666’},支持1-6个按钮。大于6个按钮时弹窗不显示。

ActionMenuSuccessResponse

操作菜单的响应结果。

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

名称 类型 必填 说明
index number 选中按钮在buttons数组中的索引,从0开始

Button

菜单中的菜单项按钮。

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

名称 类型 必填 说明
text string| Resource9+ 按钮文本内容。
color string| Resource9+ 按钮文本颜色。

艺术字体转换器