Skip to content

UIViewController:traitchange 事件 ​

traitchange 事件在页面的外观特征变化时派发,比如切到深色模式、改了文字大小。

语法 ​

page.addEventListener('traitchange', (event) => { })

事件对象 ​

UITraitChangeEvent。除了 type 和 target(这个页面),多一个只读字段:

字段类型含义
previousTraitCollectionUITraitCollection变化之前的那一组值。现在的值从 event.target.traitCollection 读

不能取消。

什么时候派发 ​

页面的 traitCollection 里有值变了时派发,包括改了 overrideUserInterfaceStyle。哪些变化会派发、要注意的地方,见外观特征。

示例 ​

js
const page = new UIViewController();
page.addEventListener('traitchange', (event) => {
  const { previousTraitCollection } = /** @type {UITraitChangeEvent} */ (event);
  console.log(previousTraitCollection.userInterfaceStyle, '→',
    page.traitCollection.userInterfaceStyle);
});
page.overrideUserInterfaceStyle = 'dark';

效果:页面在屏幕上、原来是浅色时,输出 light → dark。未在模拟器验证。

对应的 iOS API ​

-[UIViewController traitCollectionDidChange:],以及 iOS 17 起的 registerForTraitChanges:。

参见 ​