kintone API

確認ボトムシートを表示する

目次

確認ボトムシートを表示する

モバイル版の画面で確認ボトムシートを表示します。
ユーザーに確認を求めるボトムシートを表示し、ユーザーの選択を取得できます。

PC版の確認ダイアログを表示するAPIのモバイル版に相当するAPIです。 PC画面で確認ダイアログを表示する場合は 確認ダイアログを表示する APIを使用してください。

このAPIは非同期なAPIです。
同期的に処理したい場合は、次のページを参照してください。

関数

モバイル

kintone.mobile.showConfirmBottomSheet(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:表示しない
省略した場合は表示されません。

戻り値

戻り値はPromiseオブジェクトです。
Promiseオブジェクトの解決時に次の値が取得できます。

戻り値 説明
result 文字列 ユーザーが選択した操作
  • OK:OKボタンをクリック
  • CANCEL:キャンセルボタンをクリック
  • CLOSE:閉じるボタンをクリック

サンプルコード

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
// 基本的な確認ボトムシート
const result = await kintone.mobile.showConfirmBottomSheet({
  title: '確認',
  body: 'このレコードを削除しますか?',
  showOkButton: true,
  showCancelButton: true,
  okButtonText: '削除',
  cancelButtonText: 'キャンセル',
  showCloseButton: true
});

if (result === 'OK') {
  console.log('削除を実行します');
  // 削除処理
} else {
  console.log('削除をキャンセルしました');
}
表示されるUIのイメージ

ポータル画面で実行した場合の表示例です。
今後製品のアップデートにより変更される場合があります。

利用できる画面

モバイル

利用できる画面は、全体カスタマイズの適用画面に従います。
kintone全体のカスタマイズが適用される画面