Skip to content

UISwitch ​

UISwitch 表示一个开关:一条短轨道上有一个圆钮,圆钮在左边是关,在右边是开。用户点一下或者拖动圆钮来切换。它用在「某个选项要不要启用」这类只有两个取值、切换后立刻生效的地方。

开关的状态读写 isOn。用户切换之后,开关派发 change 事件;代码写 isOn 不派发。

开关的大小由系统决定,写 frame 的宽和高不起作用。开关自己不带文字,旁边的说明文字用一个 UILabel,和开关一起放进一个横向的 UIStackView。

开关是控件:禁用、状态和事件来自 UIControl。控件又是视图:位置、底色来自 UIView。

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

怎么用开关做一个设置项,见指南做开关、滑块和步进器。

构造函数 ​

UISwitch()

创建一个关着的开关。

实例属性 ​

还继承 UIControl 和 UIView 的属性。开关常用的继承属性是 isEnabled。

属性说明
isOn开着还是关着
onTintColor开着的时候轨道的颜色
thumbTintColor圆钮的颜色

实例方法 ​

还继承 UIControl 和 UIView 的方法。

方法说明
setOn()切换开关,可以带动画

事件 ​

开关的事件继承自 UIControl,用 addEventListener() 监听。开关用到的是:

事件什么时候派发
change用户把开关切到了另一边。代码写 isOn 或调 setOn() 不派发

示例 ​

一行设置项 ​

从空白 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 label = new UILabel();
  label.text = '通知';

  const sw = new UISwitch();
  sw.isOn = true;
  sw.addEventListener('change', () => {
    console.log('通知', sw.isOn ? '开' : '关');
  });

  const row = new UIStackView([label, sw]);
  row.spacing = 12;
  row.alignment = 'center';
  row.translatesAutoresizingMaskIntoConstraints = false;
  page.view.addSubview(row);
  const safe = page.view.safeAreaLayoutGuide;
  NSLayoutConstraint.activateConstraints([
    row.topAnchor.constraintEqualToAnchor(safe.topAnchor, { constant: 24 }),
    row.leadingAnchor.constraintEqualToAnchor(safe.leadingAnchor, { constant: 16 }),
  ]);
});

效果(未在模拟器验证)

  • 屏幕左上方出现「通知」两个字,右边是一个绿色的、开着的开关。
  • 点一下开关,圆钮滑到左边,轨道变灰,控制台输出 通知 关。
  • 再点一下,控制台输出 通知 开。

safeAreaLayoutGuide 是页面上不被刘海和圆角遮住的那块区域,见 Auto Layout。

对应的 iOS API ​

ObjCJS
[[UISwitch alloc] init]new UISwitch()
sw.on / sw.isOnsw.isOn
[sw setOn:YES animated:YES]sw.setOn(true, { animated: true })
sw.onTintColor = UIColor.systemPurpleColorsw.onTintColor = 'systemPurple'
[sw addTarget:self action:@selector(changed:) forControlEvents:UIControlEventValueChanged]sw.addEventListener('change', fn)

参见 ​