对话框#

Dialog 模块提供了一组用于展示对话框的快捷方法，包括提示框（Alert）、确认框（Confirm）、输入框（Prompt）和操作表（Action Sheet）。可用于在脚本执行过程中与用户进行交互。

模块：Dialog#

▸ Dialog.alert(options: { message: string, title?: string, buttonLabel?: string }): Promise<void>#

显示一个简单的提示框，包含一段信息和一个确认按钮。用户点击按钮后，Promise 会被 resolve。

参数说明#

• message (string)：提示的主要内容，必填。
• title? (string)：对话框标题，可选。
• buttonLabel? (string)：按钮文本，默认为 "OK"。

返回值#

• Promise<void>：用户点击按钮后 resolve。

示例#

1await Dialog.alert({
2  title: '提示',
3  message: '操作已成功完成。',
4  buttonLabel: '知道了'
5})

▸ Dialog.confirm(options: { message: string, title?: string, cancelLabel?: string, confirmLabel?: string }): Promise<boolean>#

显示一个确认框，包含“确认”和“取消”两个按钮。返回值表示用户是否确认。

参数说明#

• message (string)：确认信息内容，必填。
• title? (string)：标题，可选。
• cancelLabel? (string)：取消按钮文本，默认值为 "Cancel"。
• confirmLabel? (string)：确认按钮文本，默认值为 "OK"。

返回值#

• Promise<boolean>：用户点击确认返回 true，点击取消返回 false。

示例#

1const confirmed = await Dialog.confirm({
2  title: '删除文件',
3  message: '确定要删除这个文件吗？',
4  cancelLabel: '取消',
5  confirmLabel: '删除'
6})
7
8if (confirmed) {
9  // 执行删除操作
10}

▸ Dialog.prompt(options: {...}): Promise<string | null>#

显示一个输入框对话界面，允许用户输入文字。返回用户输入的字符串，或在取消时返回 null。

参数说明#

• title (string)：输入框标题，必填。
• message? (string)：辅助说明信息。
• defaultValue? (string)：默认输入值。
• obscureText? (boolean)：是否隐藏输入内容（如密码）。
• selectAll? (boolean)：是否自动选中全部默认内容。
• placeholder? (string)：输入框的占位提示文本。
• cancelLabel? (string)：取消按钮文本。
• confirmLabel? (string)：确认按钮文本。
• keyboardType? (KeyboardType)：输入键盘类型（如数字、邮箱等）。

返回值#

• Promise<string | null>：用户输入的文本，或取消时为 null。

示例#

1const name = await Dialog.prompt({
2  title: '请输入姓名',
3  placeholder: '例如：李雷',
4  defaultValue: '张三',
5  confirmLabel: '提交',
6  cancelLabel: '取消'
7})
8
9if (name != null) {
10  console.log(`你好，${name}`)
11}

▸ Dialog.actionSheet(options: {...}): Promise<number | null>#

展示一个操作表（Action Sheet），可包含多个选项按钮。点击某个按钮返回该按钮的索引，点击取消返回 null。

参数说明#

• title (string)：标题，必填。
• message? (string)：提示信息，可选。
• cancelButton? (boolean)：是否显示取消按钮，默认值为 true。
• actions ({ label: string, destructive?: boolean }[])：操作项数组，destructive 表示是否为破坏性操作（红色高亮）。

返回值#

• Promise<number | null>：返回所点击操作的索引，或用户取消时返回 null。

示例#

1const index = await Dialog.actionSheet({
2  title: '是否删除此图片？',
3  actions: [
4    { label: '删除', destructive: true },
5    { label: '保留' }
6  ]
7})
8
9if (index === 0) {
10  // 用户选择删除
11} else if (index === 1) {
12  // 用户选择保留
13} else {
14  // 用户点击了取消
15}

方法概览#