$alert

  • 更新时间:2025-08-28 20:17:11

矩形对话框

目前我们的对话框有三种:$tip、$dialog、$alert，这三种有哪些特点？

  • $tip:阻塞式对话框，很适合流程脚本，当对话框关闭后，下面的代码才会接着运行
  • $dialog:非阻塞式对话框，采用M3的风格，缺点就是由于遵循了M3布局规则导致显示的视图范围有限。
  • $alert:非阻塞式对话框，采用安卓默认实体风格，弥补$dialog显示视图小的缺点，可以通过maxWH(true)显示较大的视图区域。

create()

创建一个对话框

  • 返回 : {alert} 对话框对象
  • 版本 : 1.5.1

title(title)

设置对话框标题

  • 参数 : title {string} 对话框标题
  • 返回 : {alert} 自己
  • 版本 : 1.5.1

isShowing()

检查对话框是否正在显示

  • 返回 : {boolean} 对话框是否正在显示
  • 版本 : 1.5.1

msg(msg)

设置对话框消息

  • 参数 : msg {string} 对话框消息
  • 返回 : {alert} 自己
  • 版本 : 1.5.1

cancelable(cancelable)

设置对话框是否可以取消

  • 参数 : cancelable {boolean} 是否可以取消
  • 返回 : {alert} 自己
  • 版本 : 1.5.1

icon(icon)

设置对话框图标

  • 参数 : icon {string} 图标资源路径
  • 返回 : {alert} 自己
  • 版本 : 1.5.1

view(view)

设置对话框视图

  • 参数 : view {view} 视图
  • 返回 : {alert} 自己
  • 版本 : 1.5.1

view(view)

设置对话框视图

  • 参数 : view {xview} 视图
  • 返回 : {alert} 自己
  • 版本 : 1.5.1

maxH(max)

设置最高显示

  • 参数 : max {boolean} 是否最宽高显示
  • 返回 : {alert} 自己
  • 版本 : 1.5.1

maxW(max)

设置最宽显示

  • 参数 : max {boolean} 是否最宽显示
  • 返回 : {alert} 自己
  • 版本 : 1.5.1

maxWH(max)

设置最大宽高显示

  • 参数 : max {xview} 是否最大宽高显示
  • 返回 : {alert} 自己
  • 版本 : 1.5.1

but1(text)

设置对话框第一个按钮

  • 参数 : text {string} 按钮文本
  • 返回 : {alert} 自己
  • 版本 : 1.5.1

but1(text, callback)

设置对话框第一个按钮

回调参数：di:{DialogInterface} 接收到点击的对话框 which:{int}被点击的按钮位置

  • 参数 : text {string} 按钮文本
  • 参数 : callback {(di,which)=>{}} 回调函数
  • 返回 : {alert} 自己
  • 版本 : 1.5.1

but2(text)

设置对话框第二个按钮

  • 参数 : text {string} 按钮文本
  • 返回 : {alert} 自己
  • 版本 : 1.5.1

but2(text, callback)

设置对话框第二个按钮

回调参数：di:{DialogInterface} 接收到点击的对话框 which:{int}被点击的按钮位置

  • 参数 : text {string} 按钮文本
  • 参数 : callback {(di,which)=>{}} 回调函数
  • 返回 : {alert} 自己
  • 版本 : 1.5.1

but3(text)

设置对话框第三个按钮

  • 参数 : text {string} 按钮文本
  • 返回 : {alert} 自己
  • 版本 : 1.5.1

but3(text, callback)

设置对话框第三个按钮

回调参数：di:{DialogInterface} 接收到点击的对话框 which:{int}被点击的按钮位置

  • 参数 : text {string} 按钮文本
  • 参数 : callback {(di,which)=>{}} 回调函数
  • 返回 : {alert} 自己
  • 版本 : 1.5.1

items(items, callback)

设置对话框选项

回调参数：di:{DialogInterface} 接收到点击的对话框 which:{int}被点击的按钮位置

  • 参数 : items {string[]} 选项数组
  • 参数 : callback {(di,which)=>{}} 回调函数
  • 返回 : {alert} 自己
  • 版本 : 1.5.1

oneItems(items, checkedItem, callback)

设置对话框单选选项

回调参数：di:{DialogInterface} 接收到点击的对话框 which:{int}被点击的按钮位置

  • 参数 : items {string[]} 选项数组
  • 参数 : checkedItem {int} 选中的选项位置
  • 参数 : callback {(di,which)=>{}} 回调函数
  • 返回 : {alert} 自己
  • 版本 : 1.5.1

moreItems(items, callback)

设置对话框多选选项

回调参数：di:{DialogInterface} 接收到点击的对话框 which:{int}被点击的按钮位置 isChecked:{boolean} 是否被选中

  • 参数 : items {string[]} 选项数组
  • 参数 : callback {(di,which,isChecked)=>{}} 回调函数
  • 返回 : {alert} 自己
  • 版本 : 1.5.1

moreItems(items, checkedItems, callback)

设置对话框多选选项

回调参数：di:{DialogInterface} 接收到点击的对话框 which:{int}被点击的按钮位置 isChecked:{boolean} 是否被选中

  • 参数 : items {string[]} 选项数组
  • 参数 : checkedItems {boolean[]} 选中的选项数组
  • 参数 : callback {(di,which,isChecked)=>{}} 回调函数
  • 返回 : {alert} 自己
  • 版本 : 1.5.1

show()

显示对话框

  • 返回 : {AlertDialog} 对话框对象
  • 版本 : 1.5.1

showBefore(callback)

对话框显示前回调

需要注意的是:该回调是放在UI线程中执行的

  • 参数 : callback {()=>{}} 回调函数
  • 返回 : {alert} 自己
  • 版本 : 1.5.1

showAfter(callback)

对话框显示后回调

需要注意的是:该回调是放在UI线程中执行的

  • 参数 : callback {()=>{}} 回调函数
  • 返回 : {alert} 自己
  • 版本 : 1.5.1
//在自定义view中，如果有界面元素需要刷新，那么就最好在alert显示之后再操作
//例如:
let ui = $ui.layout("ui.xml");//解析一个视图
let mAlert = $alert.create();//创建一个对话框
mAlert.showAfter(()=>{
    //如果自定义视图中存在需要操作的ui元素，可以放到这里操作
    let but = ui.id("mButtonClose");
    mButtonClose.click(()=>{
        mAlert.close();//关闭对话框
    });
}).view(ui.getView()).show();//显示自定义视图

close()

关闭对话框

  • 版本 : 1.5.1
最近更新:
Contributors: Talent