Skip to content

UIButton ​

UIButton 表示一个按钮:屏幕上一块可以点击的区域,上面显示文字、图标,或者两者都有。用户点击按钮时,按钮派发 click 事件。

按钮的文字、文字颜色、图标和背景图按状态分别设置,按钮显示当前状态对应的那一套。

按钮是控件:禁用、状态和事件来自 UIControl。控件又是视图:位置、大小、底色、圆角来自 UIView。

继承关系:EventTarget → NSObject → UIResponder → UIView → UIControl → UIButton

怎么做一个能用的按钮,见指南做一个按钮。

构造函数 ​

UIButton()

创建一个 custom 类型的按钮。系统不给它默认外观。

静态方法 ​

UIButton.buttonWithType()

创建一个指定类型的按钮。普通的文字按钮用 'system'。

实例属性 ​

还继承 UIControl 和 UIView 的属性。按钮常用的继承属性是 isEnabled、isSelected、backgroundColor、layer。

属性说明
buttonType 只读按钮的类型,创建时确定
role按钮的用途。系统据此调整外观
currentTitle 只读按钮此刻显示的文字
currentTitleColor 只读按钮此刻的文字颜色
currentImage 只读按钮此刻显示的图标
currentBackgroundImage 只读按钮此刻显示的背景图
currentAttributedTitle 只读按钮此刻显示的带样式的文字
titleLabel 只读显示文字的 UILabel。用来设字体和行数
imageView 只读显示图标的 UIImageView

实例方法 ​

还继承 UIControl 和 UIView 的方法。

设置的方法都带 { forState },给一个或几个状态设值:

方法说明
setTitle()设文字
setTitleColor()设文字颜色
setImage()设图标,显示在文字左边
setBackgroundImage()设背景图,铺满整个按钮
setAttributedTitle()设带样式的文字

读取的方法每次读一个状态:

方法说明
titleForState()某个状态的文字
titleColorForState()某个状态的文字颜色
imageForState()某个状态的图标
backgroundImageForState()某个状态的背景图
attributedTitleForState()某个状态的带样式文字

事件 ​

按钮的事件都继承自 UIControl,用 addEventListener() 监听。按钮常用的是这几个:

事件什么时候派发
click用户完成了一次点击。响应点击用这个
touchdown手指刚按下
touchupinside手指在按钮范围内松开
touchupoutside手指按下后滑到按钮外面松开
touchcancel触摸被系统打断,比如来电

全部 16 个事件、事件对象带什么、什么时候执行回调,见 UIControl。

状态 ​

按钮在任一时刻处于一个或几个状态。设置文字、颜色、图片的方法用 forState 指定给哪些状态设。

状态什么时候处于这个状态谁来切换
normal下面几种都不是的时候—
highlighted手指按在按钮上系统
disabledisEnabled 是 falseApp 的代码
selectedisSelected 是 trueApp 的代码
focused按钮得到了焦点。什么时候会得到焦点未在模拟器验证系统
  • 没有单独设过的状态,使用 normal 的那一套。所以多数按钮只设 normal。
  • 几个状态可以同时成立,比如选中并且禁用。只在这种组合下用的值,forState 写成 ['selected', 'disabled']。
  • 当前状态从继承的 state 属性读,返回状态名的数组。

示例 ​

屏幕正中的按钮 ​

从空白 App 开始,在屏幕正中放一个按钮,点一下在控制台输出一行字。

js
application.addEventListener('sceneconnect', (e) => {
  const win = new UIWindow(e.scene);
  const page = new UIViewController();
  page.view.backgroundColor = 'systemBackground';
  win.rootViewController = page;
  win.makeKeyAndVisible();

  const button = UIButton.buttonWithType('system');
  button.setTitle('点我', { forState: ['normal'] });
  button.addEventListener('click', () => {
    console.log('按钮被点了');
  });

  button.translatesAutoresizingMaskIntoConstraints = false;
  page.view.addSubview(button);
  NSLayoutConstraint.activateConstraints([
    button.centerXAnchor.constraintEqualToAnchor(page.view.centerXAnchor),
    button.centerYAnchor.constraintEqualToAnchor(page.view.centerYAnchor),
  ]);
});

效果

  • 屏幕正中出现蓝色的「点我」,没有边框和底色。
  • 手指按住时文字变淡,松开恢复。
  • 点一下,控制台输出 按钮被点了。

这段代码没有作为一个整体在模拟器运行过。其中用到的每个 API 都在验收用例里运行过。

按状态设不同的文字 ​

js
const follow = UIButton.buttonWithType('system');
follow.setTitle('关注', { forState: ['normal'] });
follow.setTitle('已关注', { forState: ['selected'] });

follow.addEventListener('click', () => {
  follow.isSelected = !follow.isSelected;
});

效果:初始显示「关注」,点一下变成「已关注」,再点一下变回来。未在模拟器验证。

更多写法见指南做一个按钮。

对应的 iOS API ​

ObjCJS
[UIButton buttonWithType:UIButtonTypeSystem]UIButton.buttonWithType('system')
[btn setTitle:@"点我" forState:UIControlStateNormal]btn.setTitle('点我', { forState: ['normal'] })
[btn setTitle:@"x" forState:UIControlStateSelected | UIControlStateDisabled]btn.setTitle('x', { forState: ['selected', 'disabled'] })
[btn titleForState:UIControlStateHighlighted]btn.titleForState('highlighted')
[btn addTarget:self action:@selector(tap) forControlEvents:UIControlEventPrimaryActionTriggered]btn.addEventListener('click', tap)
btn.role = UIButtonRoleDestructivebtn.role = 'destructive'
btn.enabled = NObtn.isEnabled = false

参见 ​