MatchedGeometryEffect: Perfecting UI Flow in SwiftUI Apps

Creating seamless animations between views in SwiftUI is now easier than ever with the MatchedGeometryEffect. It allows developers to create smooth transitions by animating shared geometry across different views.

In this blog, we will explore how to use MatchedGeometryEffect effectively, focusing on geometry, layout, and other key properties to achieve a fluid UI experience.

What is MatchedGeometryEffect?

The MatchedGeometryEffect is a SwiftUI modifier that lets you animate between two views by sharing the same identifier within the same namespace. By defining initial and final states, this feature ensures smooth transitions for geometry like position, frame, and even background. It's commonly used in hero animations, where one view transforms into another, often accompanied by frame width and background changes.

Setting Up MatchedGeometryEffect

Before diving into examples, let's discuss the structure of this modifier. Here's a step-by-step approach to using it:

1. Define a Namespace: Use @Namespace to create a namespace shared between two views.

2. Assign Identifiers: Use a unique matchedgeometryeffect id for each pair of views.

3. Trigger Animations: Use a toggle or a similar trigger to switch between the initial and final states.

Example: Animating Two Views with MatchedGeometryEffect

Let's start with a basic hero animation example where a rectangle transitions between two views.

Code Example

Copy
import SwiftUI

struct ContentView: View {
    @Namespace private var animationNamespace
    @State private var isExpanded = false

    var body: some View {
        VStack {
            if isExpanded {
                Rectangle()
                    .fill(Color.blue)
                    .frame(width: 300, height: 300)
                    .matchedGeometryEffect(id: "rectangle", in: animationNamespace)
                    .onTapGesture { isExpanded.toggle() }
            } else {
                Circle()
                    .fill(Color.blue)
                    .frame(width: 100, height: 100)
                    .matchedGeometryEffect(id: "rectangle", in: animationNamespace)
                    .onTapGesture { isExpanded.toggle() }
            }
        }
    }
}

How it Works

• The@Namespacecreates the same namespace for two views.

• The matchedgeometryeffect id ("rectangle") ensures the geometry is shared.

• The toggle on tap switches the frame, shape, and other properties between the initial and final states.

Customizing MatchedGeometryEffect

The MatchedGeometryEffect modifier allows for significant customization:

• frame maxwidth infinity: Combine with .frame(maxWidth: .infinity) for flexible layouts.

• alignment and position: Adjust the placement of elements.

• background and fill: Animate color changes smoothly.

• spring animation: Add a natural response with .animation(.spring()).

Example with Padding and Spacer

Copy
struct AnotherExampleView: View {
    @Namespace private var animationNamespace
    @State private var isExpanded = false

    var body: some View {
        VStack {
            if isExpanded {
                RoundedRectangle(cornerRadius: 25)
                    .fill(Color.blue)
                    .frame(height: 200)
                    .padding()
                    .matchedGeometryEffect(id: "rounded", in: animationNamespace)
            } else {
                Spacer()
                RoundedRectangle(cornerRadius: 25)
                    .fill(Color.blue)
                    .frame(width: 100, height: 100)
                    .matchedGeometryEffect(id: "rounded", in: animationNamespace)
                Spacer()
            }
        }
        .onTapGesture {
            withAnimation {
                isExpanded.toggle()
            }
        }
    }
}

Advanced Techniques

Combining MatchedGeometryEffect with Other Modifiers

To create complex animations, you can combine MatchedGeometryEffect with:

• overlay: Add additional elements during the transition.

• offset: Move the view during animations.

Example: Overlay and Offset

Best Practices

1. Use Consistent Identifiers: Ensure the same identifier is used for two views.

2. Simplify Initial and Final States: Focus on animating a few properties like frame, background, or position.

3. Group Views: Wrap related views in a Group to manage complexity.

4. Avoid Unnecessary Modifiers: Stick to the matchedgeometryeffect modifier for smooth results.

Final Notes!

The MatchedGeometryEffect brings life to UI by creating smooth transitions between views. By using the same namespace and identifier, you can easily animate initial and final states with minimal effort. With these techniques, you'll master the art of fluid geometry animations in SwiftUI.

struct OverlayExampleView: View {
    @Namespace private var animationNamespace
    @State private var showDetail = false

    var body: some View {
        ZStack {
            if showDetail {
                Rectangle()
                    .fill(Color.blue)
                    .frame(maxWidth: .infinity, maxHeight: .infinity)
                    .overlay(Text("Details").font(.largeTitle).foregroundColor(.white))
                    .matchedGeometryEffect(id: "box", in: animationNamespace)
            } else {
                Circle()
                    .fill(Color.blue)
                    .frame(width: 100, height: 100)
                    .overlay(Text("Tap Me").foregroundColor(.white))
                    .matchedGeometryEffect(id: "box", in: animationNamespace)
                    .onTapGesture { withAnimation { showDetail.toggle() } }
            }
        }
    }
}