Skip to content

UIToolbar ​

UIToolbar 表示一条工具条:一个横条,里面从左到右排着若干个按钮。每个按钮是一个 UIBarButtonItem,和导航条上的按钮是同一种对象。

工具条放在哪里由 App 决定,常见的是页面底部,或者键盘的上方。工具条不是控件,自己不派发事件:点击来自里面的每一个 UIBarButtonItem,在哪个按钮上监听 click,就在哪个按钮被点时收到。

按钮之间的空白也是一个项:弹性空白 UIBarButtonItem.flexibleSpace() 占满剩下的宽度,固定空白 UIBarButtonItem.fixedSpace(width) 占给定的宽度。工具条没有对齐和间距的属性。

这一组页面里的数值和状态变化(默认值、大小、读写的结果、报错)是在模拟器(iPhone Air,iOS 27.2)上的 App 里对没有放进窗口的工具条量的。画面上的样子(按钮怎么排、颜色、动画)和真实点击未在模拟器验证。

继承关系:EventTarget → NSObject → UIResponder → UIView → UIToolbar

怎么排按钮、怎么放到页面底部和键盘上方,见指南做一个工具条。

构造函数 ​

UIToolbar()

创建一条空的工具条,frame 是 0 × 0。

实例属性 ​

还继承 UIView 的属性。工具条常用的继承属性是 frame、isHidden、intrinsicContentSize。

属性说明
items工具条上的项,从左到右。读出来是一份快照
barStyle条的明暗样式
isTranslucent条的背景是不是半透明的
tintColor按钮的文字和图标的颜色
barTintColor条自己的底色

实例方法 ​

还继承 UIView 的方法,比如 sizeToFit()。

方法说明
setItems()换一组项,可以带动画

事件 ​

工具条自己没有事件。点击在每个 UIBarButtonItem 上监听 click。

大小 ​

新建的工具条 frame 是 0 × 0。它自己想要的高度是 48 pt,对宽度没有要求:intrinsicContentSize 读出来宽是 -1(没有要求),高是 48。

  • 用 Auto Layout 定位时,约束左右两边和上边(或下边),高度不用约束。
  • 用 frame 定位时,先写 frame 给出位置和宽度,再调一次 sizeToFit()。sizeToFit() 只改高度,宽度和位置不变。

48 pt 是在 iPhone Air 模拟器(iOS 27.2)上量到的,别的机型和系统版本上是不是同一个数未验证。需要知道高度时读 intrinsicContentSize.height,不要把这个数写进代码。

示例 ​

页面底部的工具条 ​

从空白 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 toolbar = new UIToolbar();
  const add = UIBarButtonItem.systemItem('add');
  add.addEventListener('click', () => console.log('新建'));
  const trash = UIBarButtonItem.systemItem('trash');
  trash.addEventListener('click', () => console.log('删除'));
  toolbar.items = [add, UIBarButtonItem.flexibleSpace(), trash];

  const safe = page.view.safeAreaLayoutGuide;
  toolbar.translatesAutoresizingMaskIntoConstraints = false;
  page.view.addSubview(toolbar);
  NSLayoutConstraint.activateConstraints([
    toolbar.leadingAnchor.constraintEqualToAnchor(safe.leadingAnchor),
    toolbar.trailingAnchor.constraintEqualToAnchor(safe.trailingAnchor),
    toolbar.bottomAnchor.constraintEqualToAnchor(safe.bottomAnchor),
  ]);
});

效果

  • 页面底部出现一条 48 pt 高的横条,左端一个加号,右端一个垃圾桶。
  • 点加号,控制台输出 新建;点垃圾桶,输出 删除。

这段代码没有作为一个整体在模拟器运行过。

对应的 iOS API ​

ObjCJS
[[UIToolbar alloc] init]new UIToolbar()
toolbar.items = @[a, b]toolbar.items = [a, b]
toolbar.items = niltoolbar.items = null(读回来是 [])
[toolbar setItems:@[a, b] animated:YES]toolbar.setItems([a, b], { animated: true })
toolbar.barStyle = UIBarStyleBlacktoolbar.barStyle = 'black'
toolbar.translucent = NOtoolbar.isTranslucent = false
toolbar.tintColor = UIColor.systemRedColortoolbar.tintColor = 'systemRed'
toolbar.barTintColor = niltoolbar.barTintColor = null
[UIBarButtonItem flexibleSpaceItem]UIBarButtonItem.flexibleSpace()
[UIBarButtonItem fixedSpaceItemOfWidth:24]UIBarButtonItem.fixedSpace(24)

参见 ​