メインコンテンツへスキップ
バージョン: v8

@capacitor/dialog

Dialog APIは、ネイティブのダイアログウィンドウ(警告、確認、入力プロンプト)をトリガーするためのメソッドを提供します。

インストール

npm install @capacitor/dialog
npx cap sync

import { Dialog } from '@capacitor/dialog';

const showAlert = async () => {
await Dialog.alert({
title: 'Stop',
message: 'this is an error',
});
};

const showConfirm = async () => {
const { value } = await Dialog.confirm({
title: 'Confirm',
message: `Are you sure you'd like to press the red button?`,
});

console.log('Confirmed:', value);
};

const showPrompt = async () => {
const { value, cancelled } = await Dialog.prompt({
title: 'Hello',
message: `What's your name?`,
});

console.log('Name:', value);
console.log('Cancelled:', cancelled);
};

API

alert(...)

alert(options: AlertOptions) => Promise<void>

警告ダイアログを表示します。

パラメータ
optionsAlertOptions

追加日時 1.0.0


prompt(...)

prompt(options: PromptOptions) => Promise<PromptResult>

プロンプトダイアログを表示します。

パラメータ
optionsPromptOptions

戻り値: Promise<PromptResult>

追加日時 1.0.0


confirm(...)

confirm(options: ConfirmOptions) => Promise<ConfirmResult>

確認ダイアログを表示します。

パラメータ
optionsConfirmOptions

戻り値: Promise<ConfirmResult>

追加日時 1.0.0


インターフェース

AlertOptions

プロパティ説明デフォルト追加日時
title文字列ダイアログのタイトル。1.0.0
message文字列ダイアログに表示するメッセージ。1.0.0
buttonTitle文字列アクションボタンに使用するテキスト。"OK"1.0.0

PromptResult

プロパティ説明追加日時
value文字列プロンプトに入力されたテキスト。1.0.0
cancelledブール値プロンプトがキャンセルされたか、承認されたか。1.0.0

PromptOptions

プロパティ説明デフォルト追加日時
title文字列ダイアログのタイトル。1.0.0
message文字列ダイアログに表示するメッセージ。1.0.0
okButtonTitle文字列肯定的なアクションボタンに使用するテキスト。"OK"1.0.0
cancelButtonTitle文字列否定的アクションボタンに使用するテキスト。"Cancel"1.0.0
inputPlaceholder文字列ヒントのためのプレースホルダーテキスト。1.0.0
inputText文字列事前に設定されたテキスト。1.0.0

ConfirmResult

プロパティ説明追加日時
valueブール値肯定的なボタンがクリックされた場合はtrue、それ以外の場合はfalse。1.0.0

ConfirmOptions

プロパティ説明デフォルト追加日時
title文字列ダイアログのタイトル。1.0.0
message文字列ダイアログに表示するメッセージ。1.0.0
okButtonTitle文字列肯定的なアクションボタンに使用するテキスト。"OK"1.0.0
cancelButtonTitle文字列否定的アクションボタンに使用するテキスト。"Cancel"1.0.0