$alert - 原生对话框
- 更新时间:2026-02-08 19:43:42
矩形对话框
目前我们的对话框有三种:$tip($提示)、$dialog($对话框)、$alert($提示框),这三种有哪些特点?
- $tip($提示):阻塞式对话框,很适合流程脚本,当对话框关闭后,下面的代码才会接着运行
- $dialog($对话框):非阻塞式对话框,采用M3的风格,缺点就是由于遵循了M3布局规则导致显示的视图范围有限。
- $alert($提示框):非阻塞式对话框,采用安卓默认实体风格,弥补$dialog显示视图小的缺点,可以通过maxWH(true)显示较大的视图区域。
创建()
创建一个对话框
- 返回 : {$alert} 对话框对象
- 版本 : 1.7.0
标题(标题)
设置对话框标题
- 参数 : 标题 {字符串} 对话框标题
- 返回 : {$alert} 自己
- 版本 : 1.7.0
是显示的()
检查对话框是否正在显示
- 返回 : {布尔值} 对话框是否正在显示
- 版本 : 1.7.0
内容(内容)
设置对话框消息
- 参数 : 内容 {字符串} 对话框消息
- 返回 : {$alert} 自己
- 版本 : 1.7.0
可取消(可取消)
设置对话框是否可以取消
- 参数 : 可取消 {布尔值} 是否可以取消
- 返回 : {$alert} 自己
- 版本 : 1.7.0
图标(图标)
设置对话框图标
- 参数 : 图标 {字符串} 图标资源路径
- 返回 : {$alert} 自己
- 版本 : 1.7.0
视图(视图)
设置对话框视图
- 参数 : 视图 {视图} 视图
- 返回 : {$alert} 自己
- 版本 : 1.7.0
视图(视图)
设置对话框视图
- 参数 : 视图 {视图} 视图
- 返回 : {$alert} 自己
- 版本 : 1.7.0
最大高度(是否最大)
设置最高显示
- 参数 : 是否最大 {布尔值} 是否最宽高显示
- 返回 : {$alert} 自己
- 版本 : 1.7.0
最大宽度(是否最大)
设置最宽显示
- 参数 : 是否最大 {布尔值} 是否最宽显示
- 返回 : {$alert} 自己
- 版本 : 1.7.0
最大宽高(是否最大)
设置最大宽高显示
- 参数 : 是否最大 {xview} 是否最大宽高显示
- 返回 : {$alert} 自己
- 版本 : 1.7.0
按钮1(文本)
设置对话框第一个按钮
- 参数 : 文本 {字符串} 按钮文本
- 返回 : {$alert} 自己
- 版本 : 1.7.0
按钮1(文本, 回调)
设置对话框第一个按钮
回调参数:di:{DialogInterface} 接收到点击的对话框 which:{整数}被点击的按钮位置
- 参数 : 文本 {字符串} 按钮文本
- 参数 : 回调 {(di,which)=>{}} 回调函数
- 返回 : {$alert} 自己
- 版本 : 1.7.0
按钮2(文本)
设置对话框第二个按钮
- 参数 : 文本 {字符串} 按钮文本
- 返回 : {$alert} 自己
- 版本 : 1.7.0
按钮2(文本, 回调)
设置对话框第二个按钮
回调参数:di:{DialogInterface} 接收到点击的对话框 which:{整数}被点击的按钮位置
- 参数 : 文本 {字符串} 按钮文本
- 参数 : 回调 {(di,which)=>{}} 回调函数
- 返回 : {$alert} 自己
- 版本 : 1.7.0
按钮3(文本)
设置对话框第三个按钮
- 参数 : 文本 {字符串} 按钮文本
- 返回 : {$alert} 自己
- 版本 : 1.7.0
按钮3(文本, 回调)
设置对话框第三个按钮
回调参数:di:{DialogInterface} 接收到点击的对话框 which:{整数}被点击的按钮位置
- 参数 : 文本 {字符串} 按钮文本
- 参数 : 回调 {(di,which)=>{}} 回调函数
- 返回 : {$alert} 自己
- 版本 : 1.7.0
选项(选项, 回调)
设置对话框选项
回调参数:di:{DialogInterface} 接收到点击的对话框 which:{整数}被点击的按钮位置
- 参数 : 选项 {字符串数组[]} 选项数组
- 参数 : 回调 {(di,which)=>{}} 回调函数
- 返回 : {$alert} 自己
- 版本 : 1.7.0
单选(选项, 选中的下标, 回调)
设置对话框单选选项
回调参数:di:{DialogInterface} 接收到点击的对话框 which:{整数}被点击的按钮位置
- 参数 : 选项 {字符串数组[]} 选项数组
- 参数 : 选中的下标 {整数} 选中的选项位置
- 参数 : 回调 {(di,which)=>{}} 回调函数
- 返回 : {$alert} 自己
- 版本 : 1.7.0
多选(选项, 回调)
设置对话框多选选项
回调参数:di:{DialogInterface} 接收到点击的对话框 which:{整数}被点击的按钮位置 isChecked:{布尔值} 是否被选中
- 参数 : 选项 {字符串数组[]} 选项数组
- 参数 : 回调 {(di,which,isChecked)=>{}} 回调函数
- 返回 : {$alert} 自己
- 版本 : 1.7.0
多选(选项, 选中状态, 回调)
设置对话框多选选项
回调参数:di:{DialogInterface} 接收到点击的对话框 which:{整数}被点击的按钮位置 isChecked:{布尔值} 是否被选中
- 参数 : 选项 {字符串数组[]} 选项数组
- 参数 : 选中状态 {boolean[]} 选中的选项数组
- 参数 : 回调 {(di,which,isChecked)=>{}} 回调函数
- 返回 : {$alert} 自己
- 版本 : 1.7.0
显示()
显示对话框
- 返回 : {AlertDialog} 对话框对象
- 版本 : 1.7.0
显示之前(回调)
对话框显示前回调
需要注意的是:该回调是放在UI线程中执行的
- 参数 : 回调 {()=>{}} 回调函数
- 返回 : {$alert} 自己
- 版本 : 1.7.0
显示之后(回调)
对话框显示后回调
需要注意的是:该回调是放在UI线程中执行的
- 参数 : 回调 {()=>{}} 回调函数
- 返回 : {$alert} 自己
- 版本 : 1.7.0
监听关闭(回调)
监听对话框关闭
- 参数 : 回调 {()=>{}} 提示框关闭后回调
- 版本 : 1.8.0
关闭()
关闭对话框
- 版本 : 1.7.0