彈窗

說(shuō)明 本模塊首批接口從API version 8開(kāi)始支持。后續(xù)版本的新增接口，采用上角標(biāo)單獨(dú)標(biāo)記接口的起始版本。

導(dǎo)入模塊

import prompt from '@ohos.prompt'

權(quán)限列表

無(wú)

開(kāi)發(fā)前請(qǐng)熟悉鴻蒙開(kāi)發(fā)指導(dǎo)文檔 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]

prompt.showToast

showToast(options: ShowToastOptions): void

創(chuàng)建并顯示文本提示框。

系統(tǒng)能力： SystemCapability.ArkUI.ArkUI.Full

參數(shù)：

參數(shù)名	類型	必填	說(shuō)明
options	[ShowToastOptions]	是	文本彈窗選項(xiàng)。

示例：

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

ShowToastOptions

文本提示框的選項(xiàng)。

系統(tǒng)能力： 以下各項(xiàng)對(duì)應(yīng)的系統(tǒng)能力均為SystemCapability.ArkUI.ArkUI.Full。

名稱	類型	必填	說(shuō)明
message	string	是	顯示的文本信息。
duration	number	否	默認(rèn)值1500ms，建議區(qū)間：1500ms-10000ms，若小于1500ms則取默認(rèn)值。
bottom		否	設(shè)置彈窗邊框距離屏幕底部的位置。

prompt.showDialog

showDialog(options: ShowDialogOptions): Promise

創(chuàng)建并顯示對(duì)話框，對(duì)話框響應(yīng)后同步返回結(jié)果。

系統(tǒng)能力： SystemCapability.ArkUI.ArkUI.Full

參數(shù)：

參數(shù)名	類型	必填	說(shuō)明
options	[ShowDialogOptions]	是	對(duì)話框選項(xiàng)。

返回值：

類型	說(shuō)明
Promise<[ShowDialogSuccessResponse]>	對(duì)話框響應(yīng)結(jié)果。

示例：

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

創(chuàng)建并顯示對(duì)話框，對(duì)話框響應(yīng)結(jié)果異步返回。

系統(tǒng)能力： SystemCapability.ArkUI.ArkUI.Full

參數(shù)：

參數(shù)名	類型	必填	說(shuō)明
options	[ShowDialogOptions]	是	頁(yè)面顯示對(duì)話框信息描述。
callback	AsyncCallback<[ShowDialogSuccessResponse]>	是	對(duì)話框響應(yīng)結(jié)果回調(diào)。

示例：

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

對(duì)話框的選項(xiàng)。

系統(tǒng)能力： 以下各項(xiàng)對(duì)應(yīng)的系統(tǒng)能力均為SystemCapability.ArkUI.ArkUI.Full。

名稱	類型	必填	說(shuō)明
title	string	否	標(biāo)題文本。
message	string	否	內(nèi)容文本。
buttons	Array	否	對(duì)話框中按鈕的數(shù)組，結(jié)構(gòu)為：{text:'button', color: '#666666'}，支持1-3個(gè)按鈕。其中第一個(gè)為positiveButton；第二個(gè)為negativeButton；第三個(gè)為neutralButton。

ShowDialogSuccessResponse

對(duì)話框的響應(yīng)結(jié)果。

系統(tǒng)能力： 以下各項(xiàng)對(duì)應(yīng)的系統(tǒng)能力均為SystemCapability.ArkUI.ArkUI.Full。

名稱	類型	說(shuō)明
index	number	選中按鈕在buttons數(shù)組中的索引。

prompt.showActionMenu

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

創(chuàng)建并顯示操作菜單，菜單響應(yīng)結(jié)果異步返回。

系統(tǒng)能力： 以下各項(xiàng)對(duì)應(yīng)的系統(tǒng)能力均為SystemCapability.ArkUI.ArkUI.Full。

參數(shù)：

參數(shù)名	類型	必填	說(shuō)明
options	[ActionMenuOptions]	是	操作菜單選項(xiàng)。
callback	AsyncCallback<[ActionMenuSuccessResponse]>	是	菜單響應(yīng)結(jié)果回調(diào)。

示例：

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

創(chuàng)建并顯示操作菜單，菜單響應(yīng)后同步返回結(jié)果。

系統(tǒng)能力： SystemCapability.ArkUI.ArkUI.Full

參數(shù)：

參數(shù)名	類型	必填	說(shuō)明
options	[ActionMenuOptions]	是	操作菜單選項(xiàng)。

返回值：

類型	說(shuō)明
Promise<[ActionMenuSuccessResponse]>	菜單響應(yīng)結(jié)果。

示例：

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

操作菜單的選項(xiàng)。

系統(tǒng)能力： 以下各項(xiàng)對(duì)應(yīng)的系統(tǒng)能力均為SystemCapability.ArkUI.ArkUI.Full。

名稱	類型	必填	說(shuō)明
title	string	否	標(biāo)題文本。
buttons	Array	是	菜單中菜單項(xiàng)按鈕的數(shù)組，結(jié)構(gòu)為：{text:'button', color: '#666666'}，支持1-6個(gè)按鈕。大于6個(gè)按鈕時(shí)彈窗不顯示。`HarmonyOS與OpenHarmony鴻蒙文檔籽料：mau123789是v直接拿`

搜狗高速瀏覽器截圖20240326151450.png

ActionMenuSuccessResponse

操作菜單的響應(yīng)結(jié)果。

系統(tǒng)能力： 以下各項(xiàng)對(duì)應(yīng)的系統(tǒng)能力均為SystemCapability.ArkUI.ArkUI.Full。

名稱	類型	必填	說(shuō)明
index	number	否	選中按鈕在buttons數(shù)組中的索引，從0開(kāi)始。

審核編輯黃宇

聲明：本文內(nèi)容及配圖由入駐作者撰寫或者入駐合作網(wǎng)站授權(quán)轉(zhuǎn)載。文章觀點(diǎn)僅代表作者本人，不代表電子發(fā)燒友網(wǎng)立場(chǎng)。文章及其配圖僅供工程師學(xué)習(xí)之用，如有內(nèi)容侵權(quán)或者其他違規(guī)問(wèn)題，請(qǐng)聯(lián)系本站處理。舉報(bào)投訴