harmony 鸿蒙@system.prompt (弹窗)

2022-08-09
浏览 (1086)

@system.prompt (弹窗)

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

说明：

从API Version 8 开始，该接口不再维护，推荐使用新接口@ohos.promptAction (弹窗)。

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

导入模块

import prompt from '@system.prompt';

prompt.showToast

showToast(options: ShowToastOptions): void

显示文本弹窗。

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

参数：

参数名	类型	必填	说明
options	ShowToastOptions	是	定义ShowToast的选项。

示例：

import prompt from '@system.prompt';
class A{
  showToast() {
    prompt.showToast({
      message: 'Message Info',
      duration: 2000
    });
  }
}
export default new A()

prompt.showDialog

showDialog(options: ShowDialogOptions): void

显示对话框。

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

参数：

参数名	类型	必填	说明
options	ShowDialogOptions	是	定义显示对话框的选项。

示例：

import prompt from '@system.prompt';
class B{
  showDialog() {
    prompt.showDialog({
      title: 'Title Info',
      message: 'Message Info',
      buttons: [
        {
          text: 'button',
          color: '#666666'
        },
      ],
      success: (data)=> {
        console.log('dialog success callback，click button : ' + data.index);
      },
      cancel: ()=> {
        console.log('dialog cancel callback');
      },
    });
  }
}
export default new B()

prompt.showActionMenu⁶⁺

showActionMenu(options: ShowActionMenuOptions): void

显示操作菜单。

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

参数：

参数名	类型	必填	说明
options	ShowActionMenuOptions	是	定义ShowActionMenu的选项。

示例：

import prompt from '@system.prompt';
class C{
  showActionMenu() {
    prompt.showActionMenu({
      title: 'Title Info',
      buttons: [
        {
          text: 'item1',
          color: '#666666'
        },
        {
          text: 'item2',
          color: '#000000'
        },
      ],
      success: (tapIndex)=> {
        console.log('dialog success callback，click button : ' + tapIndex);
      },
      fail: (errMsg)=> {
        console.log('dialog fail callback' + errMsg);
      },
    });
  }
}
export default new C()

ShowToastOptions

定义ShowToast的选项。

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

名称	类型	必填	说明
message	string	是	显示的文本信息。
duration	number	否	默认值1500ms，建议区间：1500ms-10000ms。若小于1500ms则取默认值，最大取值为10000ms。
bottom⁵⁺	string\|number	否	设置弹窗边框距离屏幕底部的位置。

Button

定义按钮的提示信息。

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

名称	类型	必填	说明
text	string	是	定义按钮信息。
color	string	是	定义按钮颜色。

ShowDialogSuccessResponse

定义ShowDialog的响应。

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

名称	类型	必填	说明
index	number	是	定义数据的索引信息。

ShowDialogOptions

定义显示对话框的选项。

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

名称	类型	必填	说明
title	string	否	标题文本。
message	string	否	文本内容。
buttons	[Button, Button?, Button?]	否	对话框中按钮的数组，结构为：{text:‘button’, color: ‘#666666’}，支持1-6个按钮。大于6个按钮时弹窗不显示。
success	(data: ShowDialogSuccessResponse) => void	否	接口调用成功的回调函数。
cancel	(data: string, code: string) => void	否	接口调用失败的回调函数。
complete	(data: string) => void	否	接口调用结束的回调函数。

ShowActionMenuOptions⁶⁺

定义ShowActionMenu的选项。

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

名称	类型	必填	说明
title	string	否	标题文本。
buttons	[Button, Button?, Button?, Button?, Button?, Button?]	是	对话框中按钮的数组，结构为：{text:‘button’, color: ‘#666666’}，支持1-6个按钮。
success	(tapIndex: number, errMsg: string) => void	否	弹出对话框时调用。
fail	(errMsg: string) => void	否	接口调用失败的回调函数。
complete	(data: string) => void	否	关闭对话框时调用。

你可能感兴趣的鸿蒙文章

harmony 鸿蒙接口

harmony 鸿蒙系统公共事件定义(待停用)

harmony 鸿蒙系统公共事件定义

harmony 鸿蒙开发说明

harmony 鸿蒙企业设备管理概述（仅对系统应用开放）

harmony 鸿蒙BundleStatusCallback

harmony 鸿蒙@ohos.bundle.innerBundleManager (innerBundleManager模块)

harmony 鸿蒙@ohos.distributedBundle (分布式包管理)

harmony 鸿蒙@ohos.bundle (Bundle模块)

harmony 鸿蒙@ohos.enterprise.EnterpriseAdminExtensionAbility (企业设备管理扩展能力)

0 赞

所属分类： 后端技术
本文标签： 软件鸿蒙
版权声明： 原创文章如转载，请注明本文链接: https://m.seaxiang.com/blog/f8c349e599f3402297cbdf820756b12f

热门推荐

1、直接访问google.com
2、 - 优质文章
3、 gate.io
4、 harmony 鸿蒙hdc使用指导
5、 harmony 鸿蒙初识ArkTS语言
6、 flink kafka connector scan.startup.mode 的几个选项
7、 harmony 鸿蒙ArkUI组件（ArkTS）开发常见问题
8、 golang
9、 openharmony
10、 Vue中input框自动聚焦

Loading...