顯示確認對話框

目錄

顯示確認對話框

顯示確認對話框。
可以顯示對話框,要求使用者確認並取得使用者的選擇。

顯示確認對話框的API僅適用於電腦版畫面。 行動裝置畫面請使用 顯示確認底部表單 API。

此API是非同步API。
如果要同步處理,請參閱以下頁面。

函式

電腦
kintone.showConfirmDialog(config)

參數

參數名稱 類型 必須 說明
config 物件 必須 對話框設定
config.title 字串 可省略 標題字串
如果省略,則不會顯示。
config.body 字串 可省略 對話框內文文字
\n\r\r\n被解釋為換行符
如果省略,則不會顯示。
config.showOkButton 布林值 可省略 是否顯示OK按鈕
  • true:顯示
  • false:不顯示
如果省略,則會顯示。
config.okButtonText 字串 可省略 要在[OK]按鈕上顯示的文字
如果省略,將根據登入使用者的語言顯示表示「OK」的文字。
config.showCancelButton 布林值 可省略 是否顯示取消按鈕
  • true:顯示
  • false:不顯示
如果省略,則不會顯示。
config.cancelButtonText 字串 可省略 要在取消按鈕上顯示的文字
如果省略,將根據登入使用者的語言顯示表示「Cancel」的文字。
config.showCloseButton 布林值 可省略 是否顯示關閉按鈕
  • true:顯示
  • false:不顯示
如果省略,則不會顯示。
如不顯示,則使用Esc鍵關閉對話框的功能也會被停用。

返回值

返回值是Promise物件。
解析Promise物件後,可取得到以下值:

返回值 類型 說明
result 字串 使用者選擇的操作
  • OK:點擊OK按鈕
  • CANCEL:點擊取消按鈕
  • CLOSE:點擊關閉或按Esc鍵

範例代碼

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
// 通用確認對話框
const result = await kintone.showConfirmDialog({
  title: '確認',
  body: '確定要刪除此記錄嗎?',
  showOkButton: true,
  showCancelButton: true,
  okButtonText: '刪除',
  cancelButtonText: '取消',
  showCloseButton: true
});

if (result === 'OK') {
  console.log('執行刪除處理');
  // 刪除處理
} else {
  console.log('已取消刪除處理');
}

可使用的畫面

電腦版

可使用的畫面同整體自訂的套用畫面。
kintone整體自訂的套用畫面

但以下畫面不可用。

  • 搜尋畫面
  • 應用程式商城