.modifier(): що це, метод застосування модифікаторів у SwiftUI

Що таке .modifier() у SwiftUI?

.modifier() — це метод, оголошений у протоколі View: func modifier<M: ViewModifier>(_ modifier: M) -> ModifiedContent<Self, M>. Він приймає екземпляр типу, що реалізує ViewModifier, і повертає модифіковану View, обгорнуту в тип ModifiedContent.

Метод з'явився в iOS 13 і є основним способом застосування кастомних модифікаторів у SwiftUI. На відміну від вбудованих модифікаторів (font, foregroundColor, frame), які викликаються безпосередньо на View, .modifier() вимагає попереднього створення типу-модифікатора. Це додає один рівень абстракції, але відкриває можливості для перевикористання та параметризації.

За даними Hacking with Swift (2024), .modifier() використовується в кожному SwiftUI-проєкті, де потрібен єдиний стиль для повторюваних UI-елементів. Метод не додає накладних витрат порівняно з ланцюжком вбудованих модифікаторів — компілятор оптимізує виклик.

Сигнатура та типи

Метод modifier приймає дженерик-параметр M, обмежений протоколом ViewModifier. Завдяки дженерикам компілятор знає конкретний тип модифікатора та може оптимізувати результуючий тип View без стирання типу (type erasure).

Як працює метод modifier(_:)

Метод modifier(_:) створює екземпляр ModifiedContent, який пов'язує вихідну View (Self) з переданим модифікатором (M). При рендерингу SwiftUI викликає M.body(content: self), передаючи вихідну View як параметр content.

struct RoundedBorder: ViewModifier {
    let color: Color
    let width: CGFloat

    func body(content: Content) -> some View {
        content
            .padding(8)
            .overlay(
                RoundedRectangle(cornerRadius: 8)
                    .stroke(color, lineWidth: width)
            )
    }
}

// Застосувати через .modifier():
Text("Привіт")
    .modifier(RoundedBorder(color: .blue, width: 2))

// Еквівалентний прямий ланцюжок:
Text("Привіт")
    .padding(8)
    .overlay(
        RoundedRectangle(cornerRadius: 8)
            .stroke(Color.blue, lineWidth: 2)
    )

Порядок застосування: модифікатори застосовуються від зовнішнього до внутрішнього. Перший виклик .modifier() обгортає View ззовні, другий — поверх першого і так далі. Це важливо враховувати при композиції — порядок впливає на візуальний результат.

За даними Apple WWDC 2022, SwiftUI використовує Identity-оснований diffing для визначення змін в ієрархії ModifiedContent. Тип модифікатора (M) бере участь у формуванні identity View, тому різні типи модифікаторів завжди створюють нові identity, навіть якщо візуально результат однаковий.

.modifier() та вбудовані модифікатори: порівняння

Вбудовані модифікатори SwiftUI — це методи розширення, оголошені в протоколі View. Кожен вбудований модифікатор (font, foregroundColor, padding) має власну внутрішню реалізацію, оптимізовану Apple. Вони не використовують протокол ViewModifier і не викликаються через .modifier().

Коли використовувати .modifier(): коли одна комбінація модифікаторів застосовується в кількох місцях застосунку. Це забезпечує єдине джерело істини для стилю та спрощує рефакторинг. Коли використовувати прямі модифікатори: для одноразових застосувань, специфічних для конкретної View.

За даними Objc.io (2023), різниця в продуктивності між .modifier() та ланцюжком вбудованих модифікаторів статистично незначуща (менше 1% часу рендерингу). Вибір повинен визначатися читабельністю та перевикористанням, а не продуктивністю.

Умовне застосування .modifier()

Умовне застосування модифікатора — одне з частих завдань у SwiftUI. Стандартний підхід через тернарний оператор не працює з .modifier(), оскільки різні типи модифікаторів призводять до різних типів ModifiedContent.

// ❌ Не компілюється — різні типи модифікаторів:
var body: some View {
    Text("Умовний")
        .modifier(isActive ? HighlightStyle() : DefaultStyle())
}

// ✅ Правильно: if/else всередині @ViewBuilder:
@ViewBuilder
var body: some View {
    if isActive {
        Text("Умовний").modifier(HighlightStyle())
    } else {
        Text("Умовний").modifier(DefaultStyle())
    }
}

// ✅ Або модифікатор з параметром:
struct ConditionalStyle: ViewModifier {
    let isActive: Bool

    func body(content: Content) -> some View {
        content
            .foregroundColor(isActive ? .blue : .gray)
            .opacity(isActive ? 1.0 : 0.5)
    }
}

Text("Умовний").modifier(ConditionalStyle(isActive: isActive))

Рекомендація: для простих умов (показати/сховати, змінити колір) використовуйте модифікатор з параметром. Для складної умовної логіки з різними наборами модифікаторів — if/else всередині @ViewBuilder. Другий підхід більш читабельний, але може призвести до дублювання коду.

Ланцюжки та композиція модифікаторів

Ланцюжок модифікаторів — це послідовність викликів .modifier() та вбудованих модифікаторів, застосованих до однієї View. Кожен виклик створює новий шар обгортки, і всі шари об'єднуються в єдиний тип View через вкладені дженерики.

SwiftUI використовує систему типів для представлення ланцюжка модифікаторів. Наприклад, Text().font(.title).padding() має тип ModifiedContent<ModifiedContent<Text, _FontModifier>, _PaddingLayout>. Кожен вбудований модифікатор має свою внутрішню структуру-модифікатор, яка прихована від розробника.

Проблема типу: глибока вкладеність типів ModifiedContent уповільнює компіляцію та ускладнює повідомлення про помилки. Кастомні ViewModifier дозволяють «схлопнути» кілька шарів в один, спрощуючи результуючий тип та покращуючи швидкість компіляції. За даними Swift Compiler Team (2024), заміна 5–7 послідовних модифікаторів одним ViewModifier скорочує час компіляції на 10–20% для складних View.

Практичне правило: якщо View використовує більше 8 модифікаторів — винесіть частину в кастомний ViewModifier. Це прискорить компіляцію та покращить читабельність.