Skip to content

UIAlertAction ​

UIAlertAction 表示系统弹窗上的一个按钮。按钮有标题和样式,用户点了它,弹窗先关掉,然后这个按钮派发 click 事件。

按钮用 addAction() 加到弹窗上。标题和样式在创建时给,之后不能改。

继承关系:EventTarget → NSObject → UIAlertAction

怎么用按钮做出常见的弹窗,见指南弹出提示框和菜单。

构造函数 ​

不能用 new 创建。new UIAlertAction() 抛 TypeError: Illegal constructor: UIAlertAction has no public initializer; use UIAlertAction.actionWithTitle(title, { style })。用下面的静态方法创建。

静态方法 ​

UIAlertAction.actionWithTitle()

创建一个按钮,给出标题和样式。

实例属性 ​

属性说明
title 只读按钮上的字
style 只读样式:普通、取消、会删东西
isEnabled能不能点

事件 ​

事件什么时候派发
click用户点了这个按钮。弹窗关掉之后派发

系统派发的只有这一个名字。监听别的名字不会报错:它被当成自定义事件,只有自己用 dispatchEvent() 派发时才会触发。

按钮的三种样式 ​

style效果
'default'普通按钮
'cancel'取消。位置由系统安排,不按加进来的顺序。一个弹窗最多一个。底部菜单里,点菜单外面等于点它
'destructive'标题是红色,表示这个操作会删东西或者不能撤销

三种样式在屏幕上的样子未在模拟器验证。

示例 ​

js
const alert = UIAlertController.alertControllerWithTitle('删除这张照片?', {
  preferredStyle: 'alert',
});
const remove = UIAlertAction.actionWithTitle('删除', { style: 'destructive' });
remove.addEventListener('click', () => {
  console.log('照片删掉了');
});
alert.addAction(UIAlertAction.actionWithTitle('取消', { style: 'cancel' }));
alert.addAction(remove);

效果(未在模拟器验证):弹出后,提示框底下有「取消」和红色的「删除」。点「删除」,提示框消失,控制台输出 照片删掉了。

对应的 iOS API ​

ObjCJS
[UIAlertAction actionWithTitle:@"好" style:UIAlertActionStyleDefault handler:^(UIAlertAction *a) { … }]const a = UIAlertAction.actionWithTitle('好', { style: 'default' });
a.addEventListener('click', () => { … })
action.enabled = NOaction.isEnabled = false

参见 ​