弹窗

About 11 min

弹窗

导入模块

import prompt from '@system.prompt';
1

权限列表

prompt.showToast

showToast(Object): void

显示文本弹窗。

  • 参数

    参数名

    类型

    必填

    说明

    message

    string

    显示的文本信息。

    duration

    number

    默认值1500ms,建议区间:1500ms-10000ms。

    说明:

    若小于1500ms则取默认值,最大取值为10000ms。

    [bottom]5+

    <length>

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

    说明:

    仅手机和平板设备支持。

  • 示例

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

prompt.showDialog

showDialog(): void

在页面内显示对话框。

  • 参数

    参数名

    类型

    必填

    说明

    title

    string

    标题文本。

    message

    string

    内容文本。

    buttons

    Array

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

    success

    Function

    接口调用成功的回调函数,返回值如success返回值所示。

    cancel

    Function

    取消调用此接口的回调函数。

    complete

    Function

    弹框退出时的回调函数。

    success返回值:

    参数名

    类型

    说明

    index

    number

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

  • 示例

    prompt.showDialog({
      title: 'Title Info',
      message: 'Message Info',
      buttons: [
        {
          text: 'button',
          color: '#666666',
        },
      ],
      success: function(data) {
        console.log('dialog success callback,click button : ' + data.index);
      },
      cancel: function() {
        console.log('dialog cancel callback');
      },
    });
    
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16

prompt.showActionMenu6+

showActionMenu(Object): void

显示操作菜单。

  • 参数

    参数名

    类型

    必填

    说明

    title

    string

    标题文本。

    buttons

    Array

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

    success

    (data: TapIndex) => void

    接口调用成功的回调函数。

    cancel

    () => void

    接口调用失败的回调函数。

    complete

    () => void

    接口调用结束的回调函数。

    表 1 TapIndex

    参数名

    类型

    说明

    tapIndex

    number

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

  • 示例

    prompt.showActionMenu({
      title: 'Title Info',
      buttons: [
        {
          text: 'item1',
          color: '#666666',
        },
        {
          text: 'item2',
          color: '#000000',
        },
      ],
      success: function(data) {
        console.log('dialog success callback,click button : ' + data.tapIndex);
      },
      fail: function(data) {
        console.log('dialog fail callback' + data.errMsg);
      },
    });
    
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19