@Binding — что это, как работает и примеры в SwiftUI

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

@Binding — это Property Wrapper, который создаёт двустороннюю связь между свойством, хранящимся в родительском view, и дочерним компонентом. Главное отличие Binding от @State: Binding не владеет данными. Он только читает и записывает значение через истинный источник — @State, @StateObject или другой Binding в родителе. Без Binding дочерние view не могли бы модифицировать состояние предка без коллбэков или делегатов.

Binding реализован как структура с двумя свойствами: wrappedValue (текущее значение) и projectedValue (сам Binding, доступный через $). Когда дочернее view изменяет wrappedValue через Binding, SwiftUI транслирует изменение в источник данных и перерисовывает все зависимые view. Это происходит синхронно в рамках текущего цикла обновления.

Важная особенность: @Binding не ограничивается одноуровневой передачей. Binding можно передавать через несколько уровней иерархии — каждый дочерний компонент получает ссылку на один и тот же источник данных. Изменение на любом уровне вызывает единое обновление всех связанных view.

Как работает двусторонняя связь Binding

Механизм двусторонней связи через @Binding строится на проекции Property Wrappers. Когда родитель объявляет @State var value: T, SwiftUI автоматически генерирует проекцию $value типа Binding. Передавая $value в дочерний компонент с @Binding var value: T, вы соединяете оба view с одной ячейкой памяти. Любая запись через Binding в дочернем view вызывает перерисовку обоих компонентов.

struct SliderContainer: View {
    @State private var value: Double = 0.5

    var body: some View {
        VStack {
            Text("Value: \(value)")
            SliderView(value: $value)
        }
    }
}

struct SliderView: View {
    @Binding var value: Double

    var body: some View {
        Slider(value: $value, in: 0...1)
    }
}

В примере SliderContainer владеет @State value, а SliderView получает Binding через $value. Slider внутри SliderView привязан к этому Binding. При перетаскивании ползунка Slider изменяет значение через Binding, что автоматически обновляет @State в SliderContainer, и оба view отображают актуальное число. Вся цепочка работает без единого коллбэка или уведомления.

Для создания Binding из @StateObject или @ObservedObject используется та же проекция: $object.property даёт Binding. Это позволяет передавать отдельные свойства ObservableObject в дочерние view без передачи всего объекта. Такой подход даёт более узкую привязку и предотвращает лишние перерисовки.

@Binding vs колбэки: что выбрать

До SwiftUI стандартным способом передачи изменений вверх по иерархии были колбэки и делегаты: родитель передавал замыкание, дочерний компонент вызывал его при изменении. @Binding предлагает альтернативу с меньшим объёмом кода и более декларативным синтаксисом. Вместо передачи completion-замыкания достаточно передать $stateValue.

Используйте @Binding, когда дочернему view нужно только читать и изменять значение. Если требуется выполнить побочные действия при изменении (валидация, логирование, сетевой запрос), комбинируйте Binding с коллбэком: передавайте Binding для данных и замыкание для событий. Например, TextField может привязаться к Binding, а onChange будет запускать валидацию.

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

@Binding применяется в нескольких типовых сценариях. Первый — кастомные контролы: переключатели, ползунки, цветовые пикеры и другие интерактивные элементы принимают Binding для двусторонней синхронизации. Второй — модальные окна: флаг показа sheet передаётся как Binding, позволяя дочернему view закрыть себя через presentationMode или прямую установку.

Третий паттерн — формы с разделением. Если форма состоит из множества полей, каждое поле можно вынести в отдельный компонент, принимающий Binding для своего значения. Это упрощает тестирование и переиспользование полей между разными формами. Родительский компонент остаётся единственным владельцем всей модели формы.

struct FormField: View {
    let title: String
    @Binding var text: String

    var body: some View {
        VStack(alignment: .leading) {
            Text(title).font(.caption)
            TextField("Enter \(title.lowercased())", text: $text)
                .textFieldStyle(.roundedBorder)
        }
    }
}

Компонент FormField принимает заголовок и Binding к строке. Он отображает подпись и TextField, привязанный к переданному Binding. Любая форма может использовать FormField многократно, передавая $property для каждого поля. Это снижает дублирование разметки и централизует стилизацию текстовых полей.

Создание кастомных Binding

SwiftUI позволяет создавать Binding вручную через инициализатор Binding(get:set:). Это полезно, когда нужно добавить логику при чтении или записи значения. Например, можно создать Binding, который форматирует число перед сохранением, или Binding, который синхронизирует значение с удалённым сервером при каждом изменении.

struct ValidatedField: View {
    @State private var email: String = ""

    var emailBinding: Binding<String> {
        .init(
            get: { email },
            set: { email = $0.lowercased().trimmingCharacters(in: .whitespaces) }
        )
    }

    var body: some View {
        TextField("Email", text: emailBinding)
    }
}

В листинге кастомный emailBinding автоматически приводит текст к нижнему регистру и обрезает пробелы при каждом изменении. TextField использует этот Binding вместо прямой привязки к $email. Такой подход позволяет централизовать валидацию и трансформацию данных внутри Binding, не засоряя код обработчиками onChange.

Ошибки и антипаттерны с @Binding

Первая и самая распространённая ошибка — передача значения вместо Binding. Если дочерний компонент объявляет @Binding var text: String, а родитель передаёт text (без $), компилятор выдаст ошибку: Cannot convert value of type 'String' to expected argument type 'Binding'. Решение — всегда использовать префикс $ при передаче: $text.

Вторая ошибка — Binding на readonly-данные. Если дочернему view нужно только читать значение, не используйте @Binding — достаточно обычного let или @State из родителя. Binding подразумевает возможность записи, а лишние права изменения усложняют отладку и нарушают принцип минимальных привилегий.

Третья проблема — Binding.constant в продакшене. Binding.constant(value) создаёт фиктивное связывание без обратной связи — изменения игнорируются. Используйте constant только для прототипирования и превью (Xcode Previews), но никогда в реальном коде. Для тестов используйте Binding(get:set:) с контролируемым поведением.