彈窗

說明本模塊首批接口從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。

名稱	類型	必填	說明
message	string	是	顯示的文本信息。
duration	number	否	默認值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]	是	頁面顯示對話框信息描述。
callback	AsyncCallback<[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。

名稱	類型	必填	說明
title	string	否	標題文本。
message	string	否	內容文本。
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<[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。

名稱	類型	必填	說明
title	string	否	標題文本。
buttons	Array	是	菜單中菜單項按鈕的數組，結構為：{text:'button', color: '#666666'}，支持1-6個按鈕。大于6個按鈕時彈窗不顯示。`HarmonyOS與OpenHarmony鴻蒙文檔籽料：mau123789是v直接拿`