設定 SwiftUI 的 Environment 環境變數

用 .environment scene modifier 可設定特定 key path 的環境變數。

environment Scene Modifier 概覽

用 .environment scene modifier 可設定系統內建或我們自己客製的 EnvironmentValues 值。

@main
struct Example: App {
    var body: some Scene {
        WindowGroup {
            ContentView()
        }
        .environment(
            keyPath: WritableKeyPath<EnvironmentValues, V>,
            value: V
        )
    }
}

舉個例子，如果我們要將一個 Scene 設成夜間模式，可以這樣寫：

@main
struct Example: App {
    var body: some Scene {
        WindowGroup {
            ContentView()
        }
        .environment(\.colorScheme, .dark)
    }
}

key path 會用「\.」來取得某個 EnvironmentValues，而第二個參數就是我們要設定的值。

設定好環境變數之後，我們就能在這個 Scene 底下的任何子 View 裡透過 @Environment 來拿到這個值：

struct ContentView: View {
    
    @Environment(\.colorScheme) var colorScheme: ColorScheme
    
    var body: some View { ... }
}

SwiftUI 的 EnvironmentValues 環境變數

SwiftUI 內建的環境變數有非常多，主要可以分成十二大類：無障礙 Accessibility、行為 Actions、驗證 Authentication、控制與輸入 Controls and Input、顯示特性 Display Characteristics、全域物件 Global Objects、滾動 Scrolling、狀態 State、StoreKit 設定 StoreKit Configuration、文字樣式 Text Styles、畫面屬性 View Attributes、桌面小工具 Widgets。