UITraitCollection

`UITraitCollection` 简介 #

UITraitCollection 是 UIKit 提供的一个类，用于描述用户界面环境的特性集合（Traits）。它包含了关于当前用户界面的一些关键信息，比如屏幕尺寸分类、显示比例、用户界面风格（亮/暗模式）、动态字体大小等。

通过 UITraitCollection，开发者可以动态获取或响应设备的某些环境变化，从而调整界面布局或视觉效果。

主要用途 #

检测设备环境信息：
- 获取设备当前的屏幕尺寸类别（紧凑 or 正常）。
- 检测用户界面风格（Light/Dark 模式）。
- 检测设备方向、分辨率等。
响应环境变化：
- 监听或响应系统主题（如从 Light 切换到 Dark 模式）。
- 更改设备方向时动态调整布局。
- 基于动态字体设置调整界面字体大小。
用于特定环境的适配：
- 针对 iPad、iPhone 等不同设备的 UITraitCollection 特性，提供特定的布局或界面样式。
- 支持分屏、悬浮窗口多任务处理时的界面适配。

`UITraitCollection` 的常用属性 #

以下是 UITraitCollection 中的重要属性及其应用：

属性名	描述	常见值
`userInterfaceStyle`	界面风格（Light/Dark 模式）。	`.light`（亮色模式），`.dark`（暗色模式）。
`userInterfaceLevel`	界面的层级（如普通模式或隔离模式）。	`.base`（普通用户界面），`.elevated`（提升用户界面，例如模态弹出视图）。
`horizontalSizeClass`	水平方向的屏幕尺寸分类（设备的宽度适配）。	`.compact`（紧凑布局），`.regular`（正常布局）。
`verticalSizeClass`	垂直方向的屏幕尺寸分类（设备高度适配）。	`.compact`，`.regular`。
`displayScale`	设备屏幕的像素密度缩放比例。	例如 `1.0`（非 Retina 屏），`2.0`（Retina 屏），`3.0`（iPhone 13 Pro）。
`preferredContentSizeCategory`	用户在“辅助功能”中指定的字体动态调整大小。	`UIContentSizeCategory` 枚举，例如 `.large`, `.extraLarge`, `.extraSmall`。
`layoutDirection`	用户界面布局的方向（左到右，或右到左）。	`.leftToRight` 或 `.rightToLeft`。
`forceTouchCapability`	设备是否支持 3D Touch（压感触控）。	`.available`（支持），`.unavailable`（不支持）。
`legibilityWeight`	系统字体的可视性权重，在 `UIAccessibility` 环境下可能会有所调整。	`.regular`（正常），`.bold`（强调字体）。

iOS 开发中典型的 `UITraitCollection` 使用场景 #

1. 检测当前界面风格（Light/Dark 模式） #

系统从 iOS 13 开始引入了 Dark Mode，UITraitCollection 提供了对 .userInterfaceStyle 的支持，用于检测当前界面的亮/暗模式。

import UIKit

class ViewController: UIViewController {
    override func viewDidLoad() {
        super.viewDidLoad()
        
        // 检测当前界面风格
        if self.traitCollection.userInterfaceStyle == .dark {
            print("当前系统风格：Dark 🌙") // 暗黑模式
            view.backgroundColor = .black
        } else {
            print("当前系统风格：Light ☀️") // 亮色模式
            view.backgroundColor = .white
        }
    }
}

2. 响应系统风格变化 #

通过 traitCollectionDidChange(_:) 方法，我们可以在用户切换 Light/Dark 模式时，动态更新界面样式或进行布局调整。

override func traitCollectionDidChange(_ previousTraitCollection: UITraitCollection?) {
    if traitCollection.hasDifferentColorAppearance(comparedTo: previousTraitCollection) {
        // 检测到界面风格变化，更新样式
        if traitCollection.userInterfaceStyle == .dark {
            print("系统切换到了暗黑模式 🌙")
        } else {
            print("系统切换到了明亮模式 ☀️")
        }
    }
}

3. 适配尺寸分类（Size Class） #

在 iOS 开发中，针对不同设备的屏幕尺寸（紧凑/正常）进行布局适配是实现响应式设计的重要环节。开发者可以借助 horizontalSizeClass 和 verticalSizeClass 区分环境。

override func viewWillLayoutSubviews() {
    super.viewWillLayoutSubviews()
    
    // 水平方向尺寸分类
    if traitCollection.horizontalSizeClass == .compact {
        print("水平尺寸：紧凑布局")  // 例如 iPhone 竖屏
    } else if traitCollection.horizontalSizeClass == .regular {
        print("水平尺寸：正常布局")  // 例如 iPad 或 iPhone 横屏
    }
    
    // 垂直方向尺寸分类
    if traitCollection.verticalSizeClass == .compact {
        print("垂直尺寸：紧凑布局")  // 例如 iPhone 横屏
    } else if traitCollection.verticalSizeClass == .regular {
        print("垂直尺寸：正常布局")  // 例如 iPhone 竖屏
    }
}

4. 自定义子视图的 Trait Collection #

某些场景下，你可以为特定的子视图单独设置 UITraitCollection，使得该视图表现出与父视图不同的布局或样式。

// 创建一个自定义的 Trait Collection
let newTraits = UITraitCollection(userInterfaceStyle: .dark)

// 应用到子视图
let subView = UIView()
subView.frame = CGRect(x: 0, y: 0, width: 100, height: 100)
self.setOverrideTraitCollection(newTraits, forChild: subView)

// 子视图会被渲染为暗黑模式（独立于父视图的样式）

高级功能：创建和组合 `UITraitCollection` #

开发者可以创建自己的 UITraitCollection 实例，并将多个 trait 集合组合起来。在动态界面适配中非常有用。

1. 创建一个自定义的 Trait Collection #

// 单独创建一个对应 userInterfaceStyle 的 Trait Collection
let darkModeTrait = UITraitCollection(userInterfaceStyle: .dark)

// 单独创建一个对应 horizontalSizeClass 的 Trait Collection
let sizeClassTrait = UITraitCollection(horizontalSizeClass: .regular)

2. 组合多个 Trait Collection #

// 将多个 Trait Collection 合并
let combinedTrait = UITraitCollection(traitsFrom: [darkModeTrait, sizeClassTrait])

3. 应用到视图 #

// 为子视图设置 Override Trait Collection
let myView = UIView()
self.setOverrideTraitCollection(combinedTrait, forChild: myView)

总结 #

UITraitCollection 是适配环境动态变化的核心工具，其主要特点包括：

环境检测与响应：
- 通过 traitCollection 的属性（如 userInterfaceStyle）响应系统外观变化。
- 使用 horizontalSizeClass 和 verticalSizeClass 支持不同屏幕布局。
实时样式更新：
- 配合 traitCollectionDidChange(_:) 及时响应事件。
- 应用于动态布局或视觉效果切换（如切换到暗黑模式）。
灵活适配：
- 可实现子视图与父视图不同的特性设置。
- 支持组合多个特性形成复杂的适配环境。

通过合理利用 UITraitCollection，开发者可以轻松实现响应式设计，适配 iPhone、iPad，以及系统风格的动态切换等。

UITraitCollection 简介 #