default

Declaration

static let `default`: Animation

Discussion

The default animation is spring(response:dampingFraction:blendDuration:) with:

• response equal to 0.55

• dampingFraction equal to 1.0

• blendDuration equal to 0.0

Prior to iOS 17, macOS 14, tvOS 17, and watchOS 10, the default animation is easeInOut.

The global function withAnimation(_:_:) uses the default animation if you don’t provide one. For instance, the following code listing shows an example of using the default animation to flip the text “Hello” each time someone clicks the Animate button.

struct ContentView: View {
    @State private var degrees = Double.zero

    var body: some View {
        VStack {
            Spacer()
            Text("Hello")
                .font(.largeTitle)
                .rotation3DEffect(.degrees(degrees), axis: (x: 0, y: 1, z: 0))

            Spacer()
            Button("Animate") {
                withAnimation {
                    degrees = (degrees == .zero) ? 180 : .zero
                }
            }
        }
    }
}

To use the default animation when adding the animation(_:value:) view modifier, specify it explicitly as the animation type. For instance, the following code shows an example of the default animation to spin the text “Hello” each time someone clicks the Animate button.

struct ContentView: View {
    @State private var degrees = Double.zero

    var body: some View {
        VStack {
            Spacer()
            Text("Hello")
                .font(.largeTitle)
                .rotationEffect(.degrees(degrees))
                .animation(.default, value: degrees)

            Spacer()
            Button("Animate") {
                degrees = (degrees == .zero) ? 360 : .zero
            }
        }
    }
}

A default animation instance is only equal to other default animation instances (using ==), and not equal to other animation instances even when the animations are identical. For example, if you create an animation using the spring(response:dampingFraction:blendDuration:) modifier with the same parameter values that default uses, the animation isn’t equal to default. This behavior lets you differentiate between animations that you intentionally choose and those that use the default animation.