@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

Since: 1.0.0

---

prompt(...)

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

显示输入提示对话框

参数	类型
options	PromptOptions

返回值:

Promise<PromptResult>

Since: 1.0.0

---

confirm(...)

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

显示确认对话框

参数	类型
options	ConfirmOptions

返回值:

Promise<ConfirmResult>

Since: 1.0.0

---

Interfaces

AlertOptions

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

PromptResult

属性	类型	描述	Since
value	string	在提示框中输入的文本	1.0.0
cancelled	boolean	提示框是被取消还是接受	1.0.0

PromptOptions

属性	类型	描述	默认值	Since
title	string	对话框标题		1.0.0
message	string	对话框中显示的消息		1.0.0
okButtonTitle	string	正面操作按钮上显示的文本	"确定"	1.0.0
cancelButtonTitle	string	负面操作按钮上显示的文本	"取消"	1.0.0
inputPlaceholder	string	输入框的占位提示文本		1.0.0
inputText	string	预填充的文本		1.0.0

ConfirmResult

属性	类型	描述	Since
value	boolean	如果点击了正面按钮则为 true，否则为 false	1.0.0

ConfirmOptions

属性	类型	描述	默认值	Since
title	string	对话框标题		1.0.0
message	string	对话框中显示的消息		1.0.0
okButtonTitle	string	正面操作按钮上显示的文本	"确定"	1.0.0
cancelButtonTitle	string	负面操作按钮上显示的文本	"取消"	1.0.0