iOS17适配指南之UITrait

UITrait与UITraitDefinition

• iOS17 新增了一个协议UITraitDefinition，表示特征集合中特征的类型。通过遵守该协议能够完成自定义特征。
• UITrait 则是UITraitDefinition.Type的别名。

@available(iOS 17.0, tvOS 17.0, *)
public protocol UITraitDefinition {
    associatedtype Value
    static var defaultValue: Self.Value { get }
    static var identifier: String { get }
    static var name: String { get }
    static var affectsColorAppearance: Bool { get }
}
@available(iOS 17.0, tvOS 17.0, *)
public typealias UITrait = UITraitDefinition.Type

UITraitCollection

• UITraitCollection 包含的一切特征都遵守了UITraitDefinition协议。
• 增加了新的构造办法。
• 增加了修改办法。

// 创立
let customTraits = UITraitCollection { mutableTraits in
    mutableTraits.horizontalSizeClass = .compact
    mutableTraits.verticalSizeClass = .regular
    mutableTraits.userInterfaceStyle = .light
}
// 修改
let modifyTraits = customTraits.modifyingTraits { mutableTraits in
    mutableTraits.horizontalSizeClass = .regular
    mutableTraits.verticalSizeClass = .compact
    mutableTraits.userInterfaceStyle = .dark
}

traitCollectionDidChange()

UITraitEnvironment 协议中的traitCollectionDidChange()办法被抛弃，监听特征改变需要运用UITraitChangeObservable协议中的相应的特征改变注册办法。

import UIKit
extension UIColor {
    static var viewBackgroundColor: UIColor {
        .init { (trait: UITraitCollection) -> UIColor in
            if trait.userInterfaceStyle == .dark {
                return .white
            }
            return .black
        }
    }
    static var viewControllerBackgroundColor: UIColor {
        .init { (trait: UITraitCollection) -> UIColor in
            if trait.userInterfaceStyle == .dark {
                return .red
            }
            return .green
        }
    }
}
class CustomView: UIView {
    override init(frame: CGRect) {
        super.init(frame: frame)
        // iOS17之后
        registerForTraitChanges([UITraitUserInterfaceStyle.self], action: #selector(configureView))
    }
    required init?(coder: NSCoder) {
        fatalError("init(coder:) has not been implemented")
    }
    // MARK: iOS17之前，被抛弃
    override func traitCollectionDidChange(_ previousTraitCollection: UITraitCollection?) {}
    @objc private func configureView() {
        backgroundColor = .viewBackgroundColor
    }
}
class ViewController: UIViewController {
    lazy var customView: CustomView = {
        let customView = CustomView(frame: CGRect(x: 0, y: 0, width: 100, height: 100))
        customView.center = view.center
        customView.backgroundColor = .viewBackgroundColor
        return customView
    }()
    override func viewDidLoad() {
        super.viewDidLoad()
        view.backgroundColor = .viewControllerBackgroundColor
        view.addSubview(customView)
        // iOS17之后
        registerForTraitChanges([UITraitUserInterfaceStyle.self]) { (self: Self, previousTraitCollection: UITraitCollection) in
            self.view.backgroundColor = .viewControllerBackgroundColor
        }
    }
    // MARK: iOS17之前，被抛弃
    override func traitCollectionDidChange(_ previousTraitCollection: UITraitCollection?) {}
}