Skip to content

UISegmentedControl ​

UISegmentedControl 表示一个分段选择:横着排开的几段,每段是一个标题或者一张图,同一时刻最多只有一段是选中的。它用在「日 / 周 / 月」「全部 / 未读」这类在两到五个并列的选项之间切换的地方。

段用下标指代,从 0 数。选中的是哪一段读写 selectedSegmentIndex。用户点了另一段之后,控件派发 change 事件。代码改选中的段不派发 change。

刚创建出来时没有选中的段,selectedSegmentIndex 是 -1。读写某一段的内容时下标越界会抛 TypeError,不会被忽略。

控件的宽度按内容自动算,也可以用约束或 frame 给一个更大的宽度,各段平分。高度由系统决定,实测 iOS 27.2 上是 32 pt。

分段选择是控件:禁用、状态和事件来自 UIControl。控件又是视图:位置、大小、底色来自 UIView。

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

怎么用它做出常见的效果,见指南做分段选择和页码。

构造函数 ​

UISegmentedControl()

用一组标题和图创建分段选择,每一项是一段。

实例属性 ​

还继承 UIControl 和 UIView 的属性。分段选择常用的继承属性是 isEnabled、translatesAutoresizingMaskIntoConstraints。

属性说明
numberOfSegments 只读一共几段
selectedSegmentIndex选中的是第几段。-1 表示没有选中的
isMomentary点完是否不保持选中的样子,用来当一排按钮
apportionsSegmentWidthsByContent各段的宽度是按内容分还是等宽
selectedSegmentTintColor选中的那一段底下那块的颜色

实例方法 ​

还继承 UIControl 和 UIView 的方法。

加段和删段:

方法说明
insertSegmentWithTitle()插入一个标题段
insertSegmentWithImage()插入一个图片段
removeSegmentAtIndex()删掉一段
removeAllSegments()删掉全部的段

设一段的内容,下标放在 { forSegmentAtIndex } 里:

方法说明
setTitle()设这一段的标题
setImage()设这一段的图
setWidth()设这一段的宽度
setContentOffset()把这一段里的标题或图挪一点
setEnabled()单独禁用或启用这一段

读一段的内容:

方法说明
titleForSegmentAtIndex()这一段的标题
imageForSegmentAtIndex()这一段的图
widthForSegmentAtIndex()这一段的宽度
contentOffsetForSegmentAtIndex()这一段里内容的偏移
isEnabledForSegmentAtIndex()这一段是否可点

事件 ​

事件都继承自 UIControl,用 addEventListener() 监听。分段选择用到的是:

事件什么时候派发
change用户点了一段,选中的段变了。isMomentary 为 true 时每点一次都派发

示例 ​

日 / 周 / 月 ​

从空白 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 titles = ['日', '周', '月'];
  const seg = new UISegmentedControl(titles);
  seg.selectedSegmentIndex = 0;

  const label = new UILabel();
  label.text = '按日看';

  seg.addEventListener('change', () => {
    label.text = '按' + titles[seg.selectedSegmentIndex] + '看';
  });

  const column = new UIStackView([seg, label]);
  column.axis = 'vertical';
  column.spacing = 12;
  column.translatesAutoresizingMaskIntoConstraints = false;
  page.view.addSubview(column);
  const safe = page.view.safeAreaLayoutGuide;
  NSLayoutConstraint.activateConstraints([
    column.topAnchor.constraintEqualToAnchor(safe.topAnchor, { constant: 24 }),
    column.leadingAnchor.constraintEqualToAnchor(safe.leadingAnchor, { constant: 16 }),
    column.trailingAnchor.constraintEqualToAnchor(safe.trailingAnchor, { constant: -16 }),
  ]);
});

效果(未在模拟器验证)

  • 屏幕上方出现一条横贯屏幕的分段选择,三段等宽,「日」那一段是选中的样子。下面是「按日看」。
  • 点「周」,选中的那一块滑到「周」,文字变成「按周看」。
  • 再点一次已经选中的「周」,什么都不发生。

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

更多写法见指南做分段选择和页码。

对应的 iOS API ​

ObjCJS
[[UISegmentedControl alloc] initWithItems:@[@"日", @"周"]]new UISegmentedControl(['日', '周'])
seg.selectedSegmentIndex = UISegmentedControlNoSegmentseg.selectedSegmentIndex = -1
seg.momentary = YESseg.isMomentary = true
[seg insertSegmentWithTitle:@"年" atIndex:3 animated:YES]seg.insertSegmentWithTitle('年', { atIndex: 3, animated: true })
[seg removeSegmentAtIndex:0 animated:NO]seg.removeSegmentAtIndex(0)
[seg setTitle:@"本周" forSegmentAtIndex:1]seg.setTitle('本周', { forSegmentAtIndex: 1 })
[seg titleForSegmentAtIndex:1]seg.titleForSegmentAtIndex(1)
[seg setEnabled:NO forSegmentAtIndex:2]seg.setEnabled(false, { forSegmentAtIndex: 2 })
[seg setContentOffset:CGSizeMake(0, 2) forSegmentAtIndex:0]seg.setContentOffset({ width: 0, height: 2 }, { forSegmentAtIndex: 0 })
[seg addTarget:self action:@selector(changed:) forControlEvents:UIControlEventValueChanged]seg.addEventListener('change', changed)

和原生不一样的两处:

  • 原生对越界的下标有的抛异常、有的不做任何事;这里一律抛 TypeError。
  • 原生在删掉选中的那一段之后,selectedSegmentIndex 读出来是 -2;这里是 -1。

参见 ​