UIView:traitchange 事件
traitchange 事件在视图的外观特征(深浅色、屏幕倍数、文字大小等)变化时派发。
UIViewController、UIWindowScene 上也有同名事件。UIView 的子类(UIButton、UIScrollView 等)都能监听。
语法
view.addEventListener('traitchange', (event) => { })事件对象
UITraitChangeEvent。除了 type、target,多一个字段:
previousTraitCollection
UITraitCollection:变化之前的那组值。现在的值不在事件对象上,从 event.target.traitCollection 读,回调执行时它已经是新值。
事件不能取消。
什么时候派发
- 这个视图的外观特征里,
UITraitCollection的七项中有任何一项变了时派发。 - 系统切换深浅色时派发;写
overrideUserInterfaceStyle让这个视图的外观变了时也派发;用户改了系统的文字大小时也派发。三种都在模拟器上核对过。 - 其余四项(两个 size class、对比度、书写方向)变化时是否派发,未在模拟器验证。
- 一次变化派发一次。只有外观特征真的变了才派发;把
overrideUserInterfaceStyle写成和当前实际外观相同的值时是否派发,未在模拟器验证。 - 回调不是在变化的那一刻同步执行,而是稍后执行,见运行时怎么工作。
- 事件派发在被监听的那个视图上,不沿着视图树传递。一个视图的外观变了,它的子视图读到的值跟着变(已验证);在子视图上监听能收到它自己的那一次,未在模拟器验证。
UIView 自己派发的事件只有这一个。触摸不产生 UIView 的事件,要响应触摸,用手势识别器或 UIControl 的子类。
示例
js
const page = new UIViewController();
page.view.addEventListener('traitchange', (e) => {
const event = /** @type {UITraitChangeEvent} */ (e);
console.log(event.previousTraitCollection.userInterfaceStyle);
console.log(page.view.traitCollection.userInterfaceStyle);
});效果:从浅色变成深色时,依次输出 light 和 dark。
对应的 iOS API
-[UIView registerForTraitChanges:withHandler:],以及旧的 traitCollectionDidChange:。这里写成 addEventListener('traitchange', …)。