@ViewBuilder: что это, result builder для View в SwiftUI

Что такое @ViewBuilder в SwiftUI?

@ViewBuilder — это аннотация, реализующая паттерн result builder (SE-0289), которая позволяет SwiftUI собирать несколько View в одну композицию с помощью декларативного синтаксиса. Она автоматически оборачивает множественные выражения, условные конструкции и опциональные значения в соответствующие типы: TupleView, ConditionalContent, OptionalContent.

До появления result builder разработчикам приходилось вручную оборачивать элементы в VStack или HStack, а для условной логики использовать тернарные операторы или фабричные методы. @ViewBuilder сделал синтаксис SwiftUI лаконичным и читаемым, позволяя писать код, который выглядит как обычный Swift с if/else и циклами.

По данным Swift Evolution SE-0289, result builders — это общий механизм, не привязанный к SwiftUI. @ViewBuilder является одной из реализаций этого механизма, наряду с @StringBuilder для построения строк и библиотечными реализациями для других DSL. В SwiftUI @ViewBuilder используется не только для body, но и для параметров-замыканий контейнеров (VStack, HStack, ZStack, List).

Отличие от императивного подхода

В императивном UIKit вы императивно создаёте UIView, настраиваете его свойства и добавляете на иерархию через addSubview. В SwiftUI с @ViewBuilder вы декларативно описываете, какие View должны быть отображены, а SwiftUI сам управляет созданием, обновлением и удалением элементов на основе изменений состояния.

Как работает @ViewBuilder: result builder

Result builder — это механизм Swift, который преобразует последовательность выражений в одно составное значение через статические методы buildBlock, buildOptional, buildEither и другие. Когда компилятор видит аннотацию @ViewBuilder, он автоматически применяет эти методы к блоку кода в процессе компиляции.

@resultBuilder
struct ViewBuilder {
    static func buildBlock<C0, C1>(_ c0: C0, _ c1: C1) -> TupleView<(C0, C1)>
    static func buildIf<C>(_ c: C?) -> C?
    static func buildEither<T, F>(first: T) -> ConditionalContent<T, F>
    static func buildEither<T, F>(second: F) -> ConditionalContent<T, F>
}

buildBlock принимает от 1 до 10 выражений и возвращает TupleView. Каждая арность (количество выражений) имеет свою перегрузку buildBlock: от buildBlock до buildBlock. Именно поэтому количество элементов в одном @ViewBuilder блоке ограничено 10.

buildEither (first/second) обрабатывает if/else-конструкции. Каждая ветка передаётся в соответствующий метод, и результат оборачивается в ConditionalContent — тип, который скрывает конкретные типы веток и предоставляет единый интерфейс для SwiftUI.

Неявная работа @ViewBuilder

В SwiftUI свойство body уже аннотировано @ViewBuilder неявно — вы не видите эту аннотацию в коде, но компилятор применяет её автоматически. Однако для пользовательских свойств, возвращающих несколько View, или для параметров-замыканий аннотацию нужно указывать явно.

Ограничения @ViewBuilder и как их обходить

Ограничение 1 — 10 элементов в блоке. Это самое известное ограничение @ViewBuilder. Если нужно отобразить больше 10 элементов на одном уровне, компилятор выдаст ошибку. Обойти можно через Group, ForEach, List или разбивкой на подкомпоненты. Group не добавляет визуальной вложенности, но каждый Group считается одним элементом.

struct ManyElementsView: View {
    var body: some View {
        Group {
            Text("1"); Text("2"); Text("3")
            Text("4"); Text("5"); Text("6")
            Text("7"); Text("8"); Text("9")
        }
        Group {
            Text("10"); Text("11"); Text("12")
        }
    }
}

Ограничение 2 — отсутствие поддержки некоторых конструкций. @ViewBuilder не поддерживает do/catch, guard, for-in (без ForEach) и другие управляющие конструкции. Для циклов используйте ForEach с идентифицируемыми данными. Для обработки ошибок используйте отдельные View, принимающие Result или опциональные значения.

Ограничение 3 — сложность отладки. При ошибках в @ViewBuilder компилятор выдаёт многословные сообщения, в которых трудно найти корневую причину. Типичные проблемы: несоответствие типов в ветках if/else, превышение лимита в 10 элементов или отсутствие необходимой перегрузки buildBlock.

Паттерны использования @ViewBuilder

Паттерн 1: условное отображение через if/else. Самый частый сценарий использования @ViewBuilder. Позволяет показывать разные View в зависимости от состояния без использования тернарных операторов или фабричных методов.

struct StatusView: View {
    var status: LoadStatus

    @ViewBuilder
    var body: some View {
        switch status {
        case .loading:
            ProgressView("Loading...")
        case .loaded(let data):
            DataView(data: data)
        case .error(let message):
            ErrorView(message: message)
        }
    }
}

Паттерн 2: @ViewBuilder в параметрах функций и инициализаторов. Используется для создания переиспользуемых контейнеров, принимающих дочерние View через замыкание. Это стандартный паттерн для библиотек и UI-компонентов.

struct SectionCard<Content: View>: View {
    let title: String
    @ViewBuilder let content: Content

    var body: some View {
        VStack(alignment: .leading) {
            Text(title).font(.headline)
            content
        }
        .padding()
        .background(Color.gray.opacity(0.1))
        .cornerRadius(12)
    }
}

Паттерн 3: композиция с ForEach. @ViewBuilder корректно работает с ForEach, позволяя динамически генерировать элементы из массива данных. Каждый элемент ForEach считается одним выражением в контексте @ViewBuilder.

Создание кастомного ViewBuilder для переиспользуемых компонентов

Кастомный ViewBuilder — это пользовательская функция или свойство, аннотированное @ViewBuilder, которое возвращает some View. Такие функции позволяют инкапсулировать сложную логику отображения и переиспользовать её в разных частях приложения.

struct FormRow<Content: View>: View {
    let label: String
    @ViewBuilder let content: Content

    var body: some View {
        HStack {
            Text(label)
                .frame(width: 120, alignment: .trailing)
            content
        }
    }
}

// Usage:
FormRow(label: "Name") {
    TextField("Enter name", text: $name)
}

FormRow(label: "Gender") {
    Picker("Select", selection: $gender) {
        Text("Male").tag(Gender.male)
        Text("Female").tag(Gender.female)
    }
}

Важное правило: кастомная функция с @ViewBuilder должна возвращать some View, а не конкретный тип или протокол View. Только opaque type позволяет скрыть конкретную реализацию и сохранить гибкость композиции.

Производительность: кастомные @ViewBuilder функции не добавляют накладных расходов по сравнению с прямым кодом в body. Компилятор инлайнит вызовы и оптимизирует результирующий код. Разбиение body на @ViewBuilder-функции улучшает читаемость без потери производительности.