Skip to content

UIScreen:currentMode 属性 ​

currentMode 属性是这块屏幕此刻用的显示模式。

值 ​

UIScreenMode 或 null。

  • 可读,可写。
  • 在 iPhone Air 模拟器(iOS 27.2)上读到一个 UIScreenMode,它的 size 和 nativeBounds 一样大。
  • 写入用来给外接显示器换分辨率,值从 availableModes 里挑。手机自己的屏幕只有一种模式,写入没有可换的。写入的效果未在模拟器验证。
  • 变了派发 modechange 事件。

写错时 ​

写不是原生对象的值抛 TypeError:

TypeError: currentMode needs a native object or null, got "mode"

写别的原生对象(比如一个视图)也抛 TypeError,报错是 currentMode needs a UIScreenMode or null。

示例 ​

js
application.addEventListener('sceneconnect', (e) => {
  const screen = e.scene.screen;
  console.log(screen.currentMode !== null && screen.currentMode.size.width);
});

结果:在 iPhone Air 模拟器(iOS 27.2)上输出 1260。

对应的 iOS API ​

UIScreen.currentMode。

参见 ​