当前位置:诺佳网 > 电子/半导体 > 接口/总线/驱动 >

鸿蒙开发接口UI界面:【@ohos.prompt (弹窗)】

时间:2024-05-28 | 栏目:接口/总线/驱动 | 点击:

弹窗

icon-note.gif说明 本模块首批接口从API version 8开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。

导入模块

import prompt from '@ohos.prompt'

权限列表

开发前请熟悉鸿蒙开发指导文档 :[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]

prompt.showToast

showToast(options: ShowToastOptions): void

创建并显示文本提示框。

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

参数:

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

示例:

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

ShowToastOptions

文本提示框的选项。

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

名称类型必填说明
messagestring显示的文本信息。
durationnumber默认值1500ms,建议区间:1500ms-10000ms,若小于1500ms则取默认值。
bottom设置弹窗边框距离屏幕底部的位置。

prompt.showDialog

showDialog(options: ShowDialogOptions): Promise

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

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

参数:

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

返回值:

类型说明
Promise<[ShowDialogSuccessResponse]>对话框响应结果。

示例:

export default {
  showDialog() {
    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]页面显示对话框信息描述。
callbackAsyncCallback<[ShowDialogSuccessResponse]>对话框响应结果回调。

示例:

export default {
  callback(err, data) {
    if(err) {
      console.info('showDialog err: ' + err);
      return;
    }
    console.info('showDialog success callback, click button: ' + data.index);
  },
  showDialog() {
    prompt.showDialog({
      title: 'showDialog Title Info',
      message: 'Message Info',
      buttons: [
        {
          text: 'button1',
          color: '#000000',
        },
        {
          text: 'button2',
          color: '#000000',
        }
      ]
    }, this.callback);
  }
}

ShowDialogOptions

对话框的选项。

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

名称类型必填说明
titlestring标题文本。
messagestring内容文本。
buttonsArray对话框中按钮的数组,结构为:{text:'button', color: '#666666'},支持1-3个按钮。其中第一个为positiveButton;第二个为negativeButton;第三个为neutralButton。

ShowDialogSuccessResponse

对话框的响应结果。

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

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

prompt.showActionMenu

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

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

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

参数:

参数名类型必填说明
options[ActionMenuOptions]操作菜单选项。
callbackAsyncCallback<[ActionMenuSuccessResponse]>菜单响应结果回调。

示例:

export default {
  callback(err, data) {
    if(err) {
      console.info('showActionMenu err: ' + err);
      return;
    }
    console.info('showActionMenu success callback, click button: ' + data.index);
  },
  showActionMenu() {
    prompt.showActionMenu({
      title: 'Title Info',
      buttons: [
        {
          text: 'item1',
          color: '#666666',
        },
        {
           text: 'item2',
           color: '#000000',
        },
      ]
    }, this.callback)
  }
}

rompt.showActionMenu

showActionMenu(options: ActionMenuOptions): Promise

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

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

参数:

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

返回值:

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

示例:

export default {
  showActionMenu() {
    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。

名称类型必填说明
titlestring标题文本。
buttonsArray菜单中菜单项按钮的数组,结构为:{text:'button', color: '#666666'},支持1-6个按钮。大于6个按钮时弹窗不显示。HarmonyOSOpenHarmony鸿蒙文档籽料:mau123789是v直接拿

搜狗高速浏览器截图20240326151450.png

ActionMenuSuccessResponse

操作菜单的响应结果。

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

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

审核编辑 黄宇

您可能感兴趣的文章:

相关文章