Что такое PreferenceKey?

🧩 Что такое PreferenceKey?

PreferenceKey — это протокол в SwiftUI, который позволяет передавать данные вверх по иерархии представлений (child-to-parent communication), в отличие от большинства механизмов SwiftUI, работающих в нисходящем направлении (parent-to-child через инициализаторы или environment). Это мощный инструмент для сбора информации от дочерних view и её агрегации в родительском view, особенно полезный для сложных макетов, кастомной навигации или синхронизации состояний.

Основная идея и аналогия

Можно провести аналогию с «восходящим» потоком данных: представьте, что каждый дочерний элемент «сообщает» что-то своему родителю, а родитель «прислушивается» ко всем детям и принимает решение на основе совокупности данных. В SwiftUI это реализуется через модификатор .preference(key:value:) на дочернем view и .onPreferenceChange(_:perform:) или .preference(key:)_ на родительском.

Протокол PreferenceKey

Протокол требует реализации двух обязательных методов:

protocol PreferenceKey {
    associatedtype Value
    static var defaultValue: Value { get }
    static func reduce(value: inout Value, nextValue: () -> Value)
}

Компоненты протокола:

1. associatedtype Value — тип данных, которые будут передаваться (например, CGFloat, CGPoint, кастомный struct).
2. static var defaultValue: Value — значение по умолчанию, если ни одно дочернее view не установило значение для этого ключа.
3. static func reduce(value: inout Value, nextValue: () -> Value) — функция, которая определяет, как комбинировать значения от нескольких дочерних view. Это ключевой момент для агрегации данных.

Пример: определение кастомного PreferenceKey

Допустим, мы хотим собрать максимальную ширину среди дочерних текстовых полей:

import SwiftUI

// 1. Определяем ключ
struct MaxWidthKey: PreferenceKey {
    static let defaultValue: CGFloat = 0 // начальная ширина
    
    static func reduce(value: inout CGFloat, nextValue: () -> CGFloat) {
        value = max(value, nextValue()) // берём максимальное значение
    }
}

// 2. Используем в дочернем view
struct ChildView: View {
    var body: some View {
        Text("Привет, мир!")
            .background(GeometryReader { geometry in
                Color.clear
                    .preference(key: MaxWidthKey.self, 
                               value: geometry.size.width) // передаём ширину
            })
    }
}

// 3. Собираем данные в родительском view
struct ParentView: View {
    @State private var maxWidth: CGFloat = 0
    
    var body: some View {
        VStack {
            ChildView()
            ChildView()
            Text("Максимальная ширина: \(maxWidth)")
        }
        .onPreferenceChange(MaxWidthKey.self) { newWidth in
            maxWidth = newWidth // обновляем состояние при изменении
        }
    }
}

Ключевые аспекты использования:

• Агрегация данных: через reduce можно не только брать максимум, но и суммировать значения, объединять массивы и т.д. Например:

static func reduce(value: inout [CGPoint], nextValue: () -> [CGPoint]) {
    value.append(contentsOf: nextValue()) // собираем все точки
}

• Модификаторы-обёртки: SwiftUI предоставляет удобные обёртки, например @ViewBuilder с backgroundPreferenceValue или overlayPreferenceValue, которые позволяют вставлять view на основе собранных данных.

• Связь с GeometryReader: Часто используется вместе с GeometryReader для передачи геометрических данных (размеры, координаты). Это основа для кастомных layout-эффектов, например, выравнивания элементов из разных ветвей иерархии.

Практические сценарии применения:

• Кастомные навигационные панели: Передача заголовков от вложенных экранов в общий NavigationBar.
• Синхронизация размеров: Выравнивание ширины нескольких кнопок по самой широкой.
• Рисование связей: В диаграммах или графах, когда нужно соединить элементы, разбросанные по разным ветвям view-дерева.
• Оптимизация производительности: Передача данных через предпочтения может быть эффективнее, чем использование множества @State или @Binding.

Важные нюансы:

• Производительность: Данные обновляются при каждом изменении view-иерархии, но SwiftUI оптимизирует обновления.
• Порядок вызова reduce: Не гарантируется, но обычно соответствует порядку отрисовки дочерних view.
• Наследование: PreferenceKey не работает через EnvironmentObject, это отдельный механизм.

Сравнение с другими механизмами SwiftUI:

Заключение

PreferenceKey — это мощный инструмент для решения нетривиальных задач компоновки и коммуникации в SwiftUI, заполняющий пробел в «восходящем» потоке данных. Его правильное использование требует понимания работы reduce и внимания к производительности, но он открывает возможности для создания гибких и повторно используемых компонентов, которые сложно реализовать другими способами. Например, многие стандартные компоненты SwiftUI (как NavigationView с заголовками) используют подобную механику внутри себя.