SALE: Save 50% on all my books and bundles >>

How to detect the Reduce Motion accessibility setting

Paul Hudson    @twostraws   

Fully updated for Xcode 11.4

Many users are sensitive to animations, particularly those are large or complex. As a result, iOS has a built-in accessibility setting called Reduce Motion, which apps can read and respond to as appropriate.

In SwiftUI, this setting is exposed to us as an environment Boolean, so you should start by adding a property for it to your views:

@Environment(\.accessibilityReduceMotion) var reduceMotion

Now it’s down to you to decide what “reduce motion” means – should you remove your animations, or just change them to be less strong? Should you keep some important animations and just remove the ones that are for visual appeal?

For example, if you wanted a bouncy spring animation for most users, but no animation at all for users who want reduced motion, you might use an animation modifier like this one:

.animation(reduceMotion ? nil : .spring(response: 1, dampingFraction: 0.1)) 

Here’s a complete example you can try:

struct ContentView: View {
    @Environment(\.accessibilityReduceMotion) var reduceMotion
    @State var scale: CGFloat = 1

    var body: some View {
        VStack {
            Spacer()

            Circle()
                .frame(width: 20, height: 20)
                .scaleEffect(scale)
                .animation(reduceMotion ? nil : .spring(response: 1, dampingFraction: 0.1))

            Spacer()

            Button("Increase Scale") {
                self.scale *= 1.5
            }
        }
    }
}

That creates a small rectangle, scaling it up with a spring animation every time the button is pressed. But if the user enables Reduce Motion, the animation is removed entirely – it uses nil for the animation() modifier.

Hacking with Swift is sponsored by Instabug

SPONSORED Catch bugs as soon as they happen and know exactly why a crash occurred by integrating Instabug's SDK in one minute. You will automatically receive device data, network logs, and reproduction steps with every bug and crash report.

Learn more and get started for free

Sponsor Hacking with Swift and reach the world's largest Swift community!

Cascable unleashes the power of your camera and unlocks powerful workflows for shooting, managing, and geotagging your photos.

Similar solutions…

BUY OUR BOOKS
Buy Pro Swift Buy Swift Design Patterns Buy Testing Swift Buy Hacking with iOS Buy Swift Coding Challenges Buy Swift on Sundays Volume One Buy Server-Side Swift (Vapor Edition) Buy Advanced iOS Volume One Buy Advanced iOS Volume Two Buy Advanced iOS Volume Three Buy Hacking with watchOS Buy Hacking with tvOS Buy Hacking with macOS Buy Dive Into SpriteKit Buy Swift in Sixty Seconds Buy Objective-C for Swift Developers Buy Server-Side Swift (Kitura Edition) Buy Beyond Code

Was this page useful? Let us know!

Average rating: 5.0/5