Como alguns modificadores do SwiftUI modificam visualizações de nível superior?

Os valores de preferência passam dados para cima na hierarquia de exibição, de forma semelhante à forma como os valores de ambiente passam dados para baixo na hierarquia de exibição.

Os valores de preferência podem ser definidos usando preference, ou modificados usando transformPreference. Esses valores podem ser lidos por onPreferenceChange, ou backgroundPreferenceValueou overlayPreferenceValuese você quiser adicionar um plano de fundo/sobreposição com base em um valor de preferência.

Aqui está um exemplo simples para demonstrar que os valores de preferência podem ser lidos na visualização pai:

struct SomeKey: PreferenceKey {
    static let defaultValue: Int = 0
    
    static func reduce(value: inout Int, nextValue: () -> Int) {
        value += nextValue()
    }
}

struct Parent<Content: View>: View {
    let content: Content
    
    init(@ViewBuilder content: () -> Content) {
        self.content = content()
    }
    
    var body: some View {
        content
            .overlayPreferenceValue(SomeKey.self) { x in
                Text("\(x)")
            }
    }
}

#Preview {
    Parent {
        VStack {
            Color.red
                .preference(key: SomeKey.self, value: 2)
            Color.green
                .preference(key: SomeKey.self, value: 3)
        }
    }
}

Observe o reducemétodo na chave de preferência. Esse método é usado para combinar valores de preferência de visualizações irmãs, já que a pai deve receber um valor mesmo se suas subvisualizações tiverem valores de preferência diferentes definidos. No exemplo acima, a sobreposição mostra "5".

Uma invariante importante que a implementação deve satisfazer é que defaultValuedeve ser uma identidade de reduce- reduce(value: &x, nextValue: {defaultValue})não deve mudar x.

navigationTitleusa transformPreferencepara definir algum valor de preferência representando alguma configuração da barra de ferramentas. Você pode dar uma olhada nos detalhes internos do SwiftUI imprimindo

print(type(of: Text("").navigationTitle("")))

Isto imprime:

ModifiedContent<ModifiedContent<Text, TransactionalPreferenceTransformModifier<NavigationTitleKey>>, _PreferenceTransformModifier<ToolbarKey>>

_PreferenceTransformModifieré o modificador de visualização que transformPreferencese aplica e, neste caso, está transformando alguma chave de preferência chamada ToolbarKey.

toolbare presentationDetentssão mais opacos em como funcionam e podem não ser implementados usando um valor de preferência.

Há também ContainerValues. Diferentemente dos valores de preferência que enviam dados para cima na hierarquia de visualização o mais longe possível (semelhante a como os valores de ambiente são enviados o mais para baixo possível), os valores de contêiner são enviados apenas um nível acima, e o pai pode ler os valores de contêiner de cada subvisualização individual. Isso é semelhante a como tagfunciona.

Para completar, aqui está uma demonstração:

extension ContainerValues {
    @Entry var someValue = 0
}

struct Parent<Content: View>: View {
    let content: Content
    
    init(@ViewBuilder content: () -> Content) {
        self.content = content()
    }
    
    var body: some View {
        VStack {
            ForEach(subviews: content) { subview in
                subview
                    .overlay {
                        Text("\(subview.containerValues.someValue)")
                    }
            }
        }
    }
}

#Preview {
    Parent {
        Color.red
            .containerValue(\.someValue, 2)
        Color.green
            .containerValue(\.someValue, 3)
    }
}