Skip to content

UISlider ​

UISlider 表示一个滑块:一条横着的轨道上有一个圆钮,用户拖动圆钮在一个范围里选一个数。它用在音量、亮度、播放进度这类「在一段连续的范围里取值」的地方。

范围由 minimumValue 和 maximumValue 决定,默认是 0 到 1。当前的值读写 value。用户拖动时,滑块派发 change 事件;拖动途中默认连续派发很多次,isContinuous 设成 false 时只在松手时派发一次。

滑块的高度由系统决定,实测 iOS 27.2 上是 34 pt。滑块没有自己的宽度:宽度要由代码给,写 frame 或者给宽度的约束。不给宽度时它的宽是 0,屏幕上看不到。

三个数值是单精度浮点数:写 0.3 读回来是 0.30000001192092896。

滑块是控件:禁用、状态和事件来自 UIControl。

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

常见的写法见指南做开关、滑块和步进器。

构造函数 ​

UISlider()

创建一个范围 0 到 1、值为 0 的滑块。

实例属性 ​

还继承 UIControl 和 UIView 的属性。滑块常用的继承属性是 isEnabled、frame。

数值:

属性说明
value当前的值
minimumValue范围的下限
maximumValue范围的上限
isContinuous拖动途中是否一直派发 change

外观:

属性说明
sliderStyle有没有圆钮
minimumTrackTintColor圆钮左边那一段轨道的颜色
maximumTrackTintColor圆钮右边那一段轨道的颜色
thumbTintColor圆钮的颜色
minimumValueImage轨道左头外面的图
maximumValueImage轨道右头外面的图
currentThumbImage 只读当前状态下圆钮用的图
currentMinimumTrackImage 只读当前状态下左段轨道用的图
currentMaximumTrackImage 只读当前状态下右段轨道用的图

实例方法 ​

还继承 UIControl 和 UIView 的方法。

方法说明
setValue()改值,可以带动画

把圆钮和轨道换成图,按状态分别设:

方法说明
setThumbImage()设圆钮的图
setMinimumTrackImage()设左段轨道的图
setMaximumTrackImage()设右段轨道的图
thumbImageForState()某个状态下圆钮的图
minimumTrackImageForState()某个状态下左段轨道的图
maximumTrackImageForState()某个状态下右段轨道的图

各部分画在滑块里的哪个位置:

方法说明
trackRectForBounds()轨道的位置
thumbRectForBounds()值是某个数时圆钮的位置
minimumValueImageRectForBounds()左头那张图的位置
maximumValueImageRectForBounds()右头那张图的位置

事件 ​

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

事件什么时候派发
change用户拖动改了值。isContinuous 为 true 时拖动途中连续派发,为 false 时松手派发一次。代码写 value 不派发
touchdown手指按到滑块上
touchupinside、touchupoutside手指松开

示例 ​

音量滑块 ​

从空白 App 开始,在屏幕上放一个 0 到 100 的滑块,上方的文字跟着显示当前的值。

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 = '音量 40';

  // 先设范围,再设值
  const slider = new UISlider();
  slider.maximumValue = 100;
  slider.value = 40;

  slider.addEventListener('change', () => {
    label.text = '音量 ' + Math.round(slider.value);
  });

  // 纵向的 UIStackView 把滑块拉到和自己一样宽
  const column = new UIStackView([label, slider]);
  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 }),
  ]);
});

效果(未在模拟器验证)

  • 屏幕上方出现「音量 40」,下面是一条横贯屏幕的滑块,圆钮在偏左的位置。
  • 拖动圆钮,文字里的数字跟着变。
  • 拖到最右边,文字是「音量 100」。

对应的 iOS API ​

ObjCJS
[[UISlider alloc] init]new UISlider()
slider.value = 0.5fslider.value = 0.5
[slider setValue:0.5f animated:YES]slider.setValue(0.5, { animated: true })
slider.continuous = NOslider.isContinuous = false
slider.minimumTrackTintColor = UIColor.orangeColorslider.minimumTrackTintColor = 'orange'
[slider setThumbImage:image forState:UIControlStateNormal]slider.setThumbImage(image, { forState: ['normal'] })
[slider thumbImageForState:UIControlStateNormal]slider.thumbImageForState('normal')
[slider thumbRectForBounds:b trackRect:t value:v]slider.thumbRectForBounds(b, { trackRect: t, value: v })
slider.sliderStyle = UISliderStyleThumblessslider.sliderStyle = 'thumbless'

与浏览器的对照 ​

浏览器Nacre
<input type="range" min max step>new UISlider(),minimumValue、maximumValue。没有 step,见按固定的档位取值
input 事件(拖动途中)change,isContinuous 为 true
change 事件(松手时)change,isContinuous 为 false

参见 ​