UIScreen: traitCollection property
The traitCollection property is this screen's traits: dark or light, screen scale, and so on.
Value
- Read-only. Assigning to it throws
TypeError. - Each read gives the traits as of that moment.
- Its
displayScaleis the same asscale. - Screens have no trait change event. To be notified when switching between dark and light, listen for the scene's
traitchange.
Examples
js
application.addEventListener('sceneconnect', (e) => {
const screen = e.scene.screen;
console.log(screen.traitCollection.displayScale);
});Result: on the iPhone Air simulator (iOS 27.2), logs 3.
Corresponding iOS API
UIScreen.traitCollection (the UITraitEnvironment protocol).