做开关、滑块和步进器
这一篇讲怎么用三种取值的控件让用户选一个值:UISwitch(开关,两个取值)、UISlider(滑块,在一段连续的范围里取值)、UIStepper(步进器,一档一档地加减)。每个属性和方法的细节在各自的参考页。
推荐的做法
- 用
change得知值变了。 三种控件都在用户改了值之后派发change,回调里读到的是改过之后的值。代码写值不派发change,所以恢复保存的设置时直接写,不会触发自己的监听器。「代码写值不派发」验收用例断言过。 - 先设范围,再设值。 滑块和步进器写进去的值超出范围时不报错,被改成最近的那一头。先写值再改范围,值可能已经被改掉了。
- 要保存或发请求的操作,让一次拖动只处理一次。 滑块和步进器默认在拖动、按住途中连续派发
change。把isContinuous设成false,只在松手时派发一次。 - 开关和步进器的大小由系统决定,只给位置的约束。滑块要给宽度。
第一个例子
从空白 App 开始,在页面上竖着排一个开关、一个滑块和一个步进器,每个控件变了都在控制台输出当前的值。
application.addEventListener('sceneconnect', (e) => {
// 建窗口和页面。每个 App 都要有这几行
const win = new UIWindow(e.scene);
const page = new UIViewController();
page.view.backgroundColor = 'systemBackground';
win.rootViewController = page;
win.makeKeyAndVisible();
// 1. 开关
const sw = new UISwitch();
sw.addEventListener('change', () => {
console.log('开关', sw.isOn);
});
// 2. 滑块:先设范围,再设值
const slider = new UISlider();
slider.maximumValue = 100;
slider.value = 40;
slider.addEventListener('change', () => {
console.log('滑块', Math.round(slider.value));
});
// 3. 步进器
const stepper = new UIStepper();
stepper.minimumValue = 1;
stepper.maximumValue = 10;
stepper.value = 1;
stepper.addEventListener('change', () => {
console.log('步进器', stepper.value);
});
// 4. 竖着排好放到页面上。滑块被拉到和这一列一样宽
const column = new UIStackView([sw, slider, stepper]);
column.axis = 'vertical';
column.spacing = 20;
column.alignment = 'leading';
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 }),
slider.widthAnchor.constraintEqualToAnchor(column.widthAnchor),
]);
});效果(未在模拟器验证)
- 页面上方从上到下是一个关着的开关、一条横贯页面的滑块、一个步进器。
- 点开关,控制台输出
开关 true。 - 拖滑块,控制台连续输出
滑块 41、滑块 42这样的行。 - 点步进器的加号,控制台输出
步进器 2。
alignment = 'leading' 让开关和步进器保持系统给的大小、靠左摆;滑块另外用一条约束拉到和这一列一样宽。下面各节沿用这里的 sw、slider 和 stepper。单独试某一节时,先写这几行:
const page = new UIViewController();
const sw = new UISwitch();
const slider = new UISlider();
const stepper = new UIStepper();
const column = new UIStackView([sw, slider, stepper]);
column.axis = 'vertical';
page.view.addSubview(column);开关
带动画地切换
sw.setOn(false, { animated: true });
console.log(sw.isOn);效果:圆钮滑到左边(未在模拟器验证)。控制台输出 false:值在调用返回时就已经变了,不用等动画结束。
setOn() 和写 isOn 一样不派发 change。
换开关的颜色
sw.onTintColor = '#5856D6';
sw.thumbTintColor = '#FFFFFF';效果(未在模拟器验证):开着的时候轨道是紫色,圆钮是白色。
两个属性写 null 都回到系统默认的颜色。颜色的写法见颜色。
让开关不能点
sw.isEnabled = false;效果(未在模拟器验证):开关变淡,点它没有反应,也不派发事件。
isEnabled 继承自 UIControl。禁用之后代码仍然可以写 isOn。
保存失败时把开关改回去
/** @param {boolean} on @returns {Promise<void>} */
async function save(on) {
// 把设置发给服务器
}
sw.addEventListener('change', async () => {
const wanted = sw.isOn;
try {
await save(wanted);
} catch (err) {
sw.setOn(!wanted, { animated: true });
}
});效果(未在模拟器验证):用户切换后开关立刻变过去;保存失败时开关滑回原来的位置。
改回去用的是 setOn(),它不派发 change,所以不会再触发一次保存。
滑块
只在松手时处理
slider.isContinuous = false;
slider.addEventListener('change', () => {
console.log('选定了', Math.round(slider.value));
});效果(未在模拟器验证):拖动途中不输出。松手时输出一次,比如 选定了 72。
让滑块按固定的档位取值
滑块本身不分档。在回调里把值取整之后写回去,圆钮就停在档位上:
slider.addEventListener('change', () => {
const step = 10;
slider.value = Math.round(slider.value / step) * step;
console.log('音量', slider.value);
});效果(未在模拟器验证):拖动时圆钮每 10 一档地跳,控制台只出现 0、10、20 这样的数。
回调里写 value 不会再派发 change,所以不会循环。
显示滑块的值
滑块的三个数值是单精度浮点数:写 0.3 读回来是 0.30000001192092896。显示之前先取整或者保留固定的小数位:
slider.maximumValue = 1;
slider.value = 0.3;
console.log(slider.value.toFixed(2));效果:控制台输出 0.30。
比较两个值时也不要用 === 比小数。
带动画地改滑块的值
slider.maximumValue = 100;
slider.setValue(80, { animated: true });
console.log(slider.value);效果:圆钮滑到 80 的位置(未在模拟器验证)。控制台输出 80:值在调用返回时就已经变了。
换滑块的颜色
slider.minimumTrackTintColor = '#FF9500';
slider.maximumTrackTintColor = 'systemGray';
slider.thumbTintColor = '#FFFFFF';效果(未在模拟器验证):圆钮左边那一段轨道是橙色,右边那一段是灰色,圆钮是白色。
三个属性写 null 都回到系统默认的颜色。
在轨道两头放图标
slider.minimumValueImage = UIImage.systemImageNamed('speaker.fill');
slider.maximumValueImage = UIImage.systemImageNamed('speaker.wave.3.fill');效果(未在模拟器验证):轨道左头外面是一个小喇叭,右头外面是一个带声波的喇叭。轨道相应变短。
systemImageNamed() 取的是 SF Symbols,系统自带的一套图标,见 UIImage。
让一个气泡跟着圆钮走
thumbRectForBounds() 给出圆钮画在滑块里的哪个位置。拿它去定另一个视图的位置:
const bubble = new UILabel();
bubble.textAlignment = 'center';
slider.addSubview(bubble);
slider.addEventListener('change', () => {
const track = slider.trackRectForBounds(slider.bounds);
const thumb = slider.thumbRectForBounds(slider.bounds, { trackRect: track, value: slider.value });
bubble.text = String(Math.round(slider.value));
bubble.frame = new CGRect(thumb.x, thumb.y - 28, thumb.width, 24);
});效果(未在模拟器验证):拖动时,圆钮正上方有一个数字跟着移动。
实测一条 300 × 34 pt、没有两头图标的滑块:轨道是 (0, 14, 300, 6);值在最小时圆钮是 (0, 5, 37, 24),值在最大时是 (263, 5, 37, 24)。
不要圆钮
slider.sliderStyle = 'thumbless';效果(未在模拟器验证):滑块上没有圆钮,只剩一条填了一部分的轨道。一般用来显示播放进度。
步进器
每次加减 0.5
stepper.stepValue = 0.5;效果(未在模拟器验证):点一下加号,值从 1 变成 1.5。
步进器不会把值对齐到 stepValue 的倍数:代码写 stepper.value = 1.3,之后点加号得到 1.8(未在模拟器验证)。
加到头之后回到最小值
stepper.wraps = true;效果(未在模拟器验证):值是 10 时点加号,变成 1;值是 1 时点减号,变成 10。两个按钮一直可点。
wraps 只影响用户点按钮。代码写超出范围的值时,值仍然被改成最近的那一头:实测开着 wraps 写 500,读回来是上限。
按住时不要连续变化
stepper.autorepeat = false;效果(未在模拟器验证):按住加号不放,值只加一次。
按住连加时,只在松手后处理一次
stepper.isContinuous = false;
stepper.addEventListener('change', () => {
console.log('定了', stepper.value);
});效果(未在模拟器验证):按住加号时值在连续增加,但不输出。松手后输出一次。
把步进器的值显示出来
步进器不显示数值。旁边放一个 UILabel,在 change 里更新:
const count = new UILabel();
count.text = '数量 ' + stepper.value;
stepper.addEventListener('change', () => {
count.text = '数量 ' + stepper.value;
});效果:每点一下加号或减号,文字跟着变。count 还要放到页面上,写法见 UIStepper 的示例。