@capacitor/dialog

Dialog API 提供了触发原生对话框窗口的方法，可用于警告、确认和输入提示

安装

npm install @capacitor/dialog
npx cap sync

示例

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

const showAlert = async () => {
  await Dialog.alert({
    title: '停止',
    message: '这是一个错误',
  });
};

const showConfirm = async () => {
  const { value } = await Dialog.confirm({
    title: '确认',
    message: `确定要按下红色按钮吗？`,
  });

  console.log('已确认:', value);
};

const showPrompt = async () => {
  const { value, cancelled } = await Dialog.prompt({
    title: '你好',
    message: `请问你的名字是？`,
  });

  console.log('姓名:', value);
  console.log('已取消:', cancelled);
};

API

• alert(...)
• prompt(...)
• confirm(...)
• 接口

alert(...)

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

显示警告对话框

参数	类型
options	AlertOptions

自: 1.0.0

---

prompt(...)

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

显示输入对话框

参数	类型
options	PromptOptions

返回值:

Promise<PromptResult>

自: 1.0.0

---

confirm(...)

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

显示确认对话框

参数	类型
options	ConfirmOptions

返回值:

Promise<ConfirmResult>

自: 1.0.0

---

Interfaces

AlertOptions

属性	类型	描述	默认值	自
title	string	对话框标题		1.0.0
message	string	对话框中显示的消息		1.0.0
buttonTitle	string	操作按钮上显示的文本	"OK"	1.0.0

PromptResult

属性	类型	描述	自
value	string	输入框中输入的文本	1.0.0
cancelled	boolean	对话框是否被取消	1.0.0

PromptOptions

属性	类型	描述	默认值	自
title	string	对话框标题		1.0.0
message	string	对话框中显示的消息		1.0.0
okButtonTitle	string	确认按钮上显示的文本	"OK"	1.0.0
cancelButtonTitle	string	取消按钮上显示的文本	"Cancel"	1.0.0
inputPlaceholder	string	输入框的提示文本		1.0.0
inputText	string	输入框中预填充的文本		1.0.0

ConfirmResult

属性	类型	描述	自
value	boolean	若点击了确认按钮则为 true，否则为 false	1.0.0

ConfirmOptions

属性	类型	描述	默认值	自
title	string	对话框标题		1.0.0
message	string	对话框中显示的消息		1.0.0
okButtonTitle	string	确认按钮上显示的文本	"OK"	1.0.0
cancelButtonTitle	string	取消按钮上显示的文本	"Cancel"	1.0.0