@Environment в SwiftUI — какво е, ключови понятия и механизъм

Какво е @Environment в SwiftUI?

@Environment — е SwiftUI property wrapper, предназначен за четене на стойности от системната среда. Средата е йерархичен контейнер от стойности, който SwiftUI автоматично разпространява от родителските View към дъщерните. Всяка стойност на средата се идентифицира чрез ключ — тип, съответстващ на протокола EnvironmentKey.

Механизмът на средата наподобява dependency injection на ниво framework: системата предоставя предварително дефиниран набор от стойности — цветова схема (светла/тъмна), locale, размер на шрифта, managedObjectContext за Core Data, dismiss за затваряне на екрана и много други. View, което е декларирало @Environment с определен ключ, автоматично получава текущата стойност и се прерисува при нейната промяна.

Архитектурата на средата на SwiftUI се основава на протокола EnvironmentValues — структура, съдържаща всички системни стойности. Всяка стойност се съхранява като свойство на тази структура с getter и setter. @Environment използва key path за достъп до конкретно свойство: @Environment(\.colorScheme) — достъп до цветова схема, @Environment(\.locale) — до locale.

@Environment като Property Wrapper

Property wrapper @Environment имплементира два ключови механизма: четене на стойност от средата и абониране за нейните промени. При създаване на View, SwiftUI преминава през всички @Environment свойства и ги свързва със съответните стойности от текущия контекст. Ако родителско View промени стойността чрез модификатора .environment(), всички дъщерни View, които четат тази стойност, автоматично се прерисуват.

Важна характеристика: @Environment поддържа опционални стойности. Ако стойност не е зададена в йерархията, се връща стойността по подразбиране, дефинирана в EnvironmentKey. За системните ключове стойността по подразбиране винаги е разумна — например цветовата схема по подразбиране е .light. За персонализирани ключове разработчикът сам определя стойността по подразбиране в метода defaultValue на протокола EnvironmentKey.

struct EnvironmentReaderView: View {
    @Environment(\.colorScheme) var colorScheme
    @Environment(\.locale) var locale
    @Environment(\.sizeCategory) var sizeCategory

    var body: some View {
        VStack {
            Text("Текуща схема: \(colorScheme == .dark ? "Dark" : "Light")")
            Text("Locale: \(locale.identifier)")
            Text("Размер на шрифт: \(sizeCategory)")
        }
    }
}

В примера View чете три системни стойности на средата. При промяна на colorScheme — например, потребителят е включил тъмен режим в настройките — View автоматично се прерисува с новата стойност. Подобно при промяна на региона или размера на шрифта (Dynamic Type). View не трябва да се абонира за известия или да вика опресняване — SwiftUI управлява това автоматично.

Системни стойности на средата

SwiftUI предоставя десетки системни стойности на средата, покриващи различни аспекти на интерфейса и поведението. Цветова схема (\.colorScheme) — една от най-търсените стойности, позволяваща адаптиране на интерфейса към светла и тъмна тема. Locale (\.locale) съдържа регионалните настройки на потребителя за форматиране на дати, числа и валути.

За Core Data се използва managedObjectContext (\.managedObjectContext) — контекст, предаван чрез средата от persistence контейнера. За навигация са достъпни dismiss (\.dismiss) за затваряне на текущия екран и isPresented (\.isPresented) за модални изгледи. За календар и часова зона — calendar и timeZone.

За достъп до системните стойности използвайте key path чрез точка: @Environment(\.dismiss) var dismiss. Компилаторът проверява съществуването на key path в EnvironmentValues, така че грешен ключ ще предизвика грешка на етапа на компилация. Нови системни стойности се добавят от Apple с всяка версия на iOS — актуалният списък е достъпен в документацията на EnvironmentValues.

@Environment срещу @EnvironmentObject

Въпреки подобните имена, @Environment и @EnvironmentObject решават различни задачи. @Environment чете системни или персонализирани стойности, регистрирани чрез EnvironmentKey. @EnvironmentObject — е property wrapper за ObservableObject, предаван чрез средата по тип, без изричен ключ.

@EnvironmentObject се използва за dependency injection: родителско View създава обект (например ViewModel) и го предава на дъщерните View чрез модификатора .environmentObject(). Дъщерните View го получават чрез @EnvironmentObject и могат както да четат, така и да променят неговите свойства. @Environment, от друга страна — само за четене на системни стойности и не поддържа обратна връзка.

На практика: използвайте @Environment за достъп до системни параметри (тема, locale, размер на шрифта) и персонализирани конфигурации, които не се променят по време на изпълнение. Използвайте @EnvironmentObject за предаване на ViewModel или услуга през йерархията на View, когато е необходимо променяне на състоянието от дъщерни компоненти.

Примери за код на @Environment

Нека разгледаме създаването на персонализирана стойност на средата. За целта трябва да дефинирате структура, съответстваща на протокола EnvironmentKey, и да разширите EnvironmentValues с ново свойство. Това позволява предаване на конфигурация на тема или настройки на приложението през цялото дърво на View без props.

struct AppThemeKey: EnvironmentKey {
    static let defaultValue: AppTheme = .system
}

extension EnvironmentValues {
    var appTheme: AppTheme {
        get { self[AppThemeKey.self] }
        set { self[AppThemeKey.self] = newValue }
    }
}

enum AppTheme { case system, light, dark }

Протоколът EnvironmentKey изисква имплементация на статичното свойство defaultValue — стойността, която ще се използва, ако родителското View не е задало персонализирана среда. Разширението на EnvironmentValues добавя изчисляемото свойство appTheme, използвайки subscript с ключ. След това всяко View може да чете стойността чрез @Environment(\.appTheme).

Използване на @Environment с персонализиран ключ

struct ThemedView: View {
    @Environment(\.appTheme) var appTheme
    @Environment(\.colorScheme) var colorScheme

    var body: some View {
        VStack {
            if appTheme == .dark || (appTheme == .system && colorScheme == .dark) {
                Text("Тъмен режим активен")
                    .foregroundStyle(.white)
                    .background(Color.black)
            } else {
                Text("Светъл режим активен")
                    .foregroundStyle(.black)
                    .background(Color.white)
            }
        }
    }
}

struct ContentView: View {
    @State private var selectedTheme = AppTheme.system

    var body: some View {
        ThemedView()
            .environment(\.appTheme, selectedTheme)
    }
}

ThemedView чете две среди: персонализирана appTheme и системна colorScheme. Комбинацията позволява имплементиране на гъвкаво настройване на темата: потребителят може да избере „Светла”, „Тъмна” или „Системна” тема. Ако е избрана системна — стойността се взема от colorScheme, което автоматично се променя при превключване на темата в настройките на iOS. Родителското View (ContentView) задава стойността appTheme чрез модификатора .environment().

Използване на dismiss за затваряне на екран

struct ModalView: View {
    @Environment(\.dismiss) var dismiss
    @State private var name = ""

    var body: some View {
        NavigationStack {
            Form {
                TextField("Your name", text: $name)
                Button("Запазване") { dismiss() }
            }
            .navigationTitle("Edit Profile")
        }
    }
}

Този пример демонстрира практическото използване на dismiss — екземпляр на DismissAction от средата. Извикването на dismiss() като функция затваря модалния екран или връща NavigationLink. Единственото изискване — View трябва да бъде представено модално или да се намира вътре в NavigationStack. dismiss автоматично се определя от контекста: ако View е отворено като sheet — затваря се sheet, ако като popover — затваря се popover.