How to create keyframe animations using animateKeyframes()

Paul Hudson    February 13th 2018    @twostraws

If you need to combine a selection of animations over time the easiest thing to do is create a keyframe animation. This starts with a call to animateKeyframes(), then you go ahead and call addKeyframe() as many times as you need.

Each keyframe you add has a relative start time and relative duration, so they work independently of the overall timing. You also provide each keyframe with the animation it should perform, again not worrying about the rest of the animation. When it runs, iOS combines them all together, blending one animation seamlessly into the next.

To give you an example, here’s some code that moves and scales an image view around the screen:

let start = self.imageView.center

UIView.animateKeyframes(withDuration: 5, delay: 0, options: .calculationModeCubic, animations: {
    UIView.addKeyframe(withRelativeStartTime: 0.0, relativeDuration: 0.25) {
        self.imageView.transform = CGAffineTransform(scaleX: 2, y: 2)
    }

    UIView.addKeyframe(withRelativeStartTime: 0.25, relativeDuration: 0.25) {
        self.imageView.center = CGPoint(x: self.view.bounds.midX, y: self.view.bounds.maxY)
    }

    UIView.addKeyframe(withRelativeStartTime: 0.5, relativeDuration: 0.25) {
        self.imageView.center = CGPoint(x: self.view.bounds.width, y: start.y)
    }

    UIView.addKeyframe(withRelativeStartTime: 0.75, relativeDuration: 0.25) {
        self.imageView.center = start
    }
})

The calculationModeCubic option tells iOS to blend the animations together, so you’ll see the image view overshoot one animation as it curves into the next. You should also try using calculationModeCubicPaced instead – in the above code it makes the scaling part run over the entire length of the animation.

Available from iOS 7.0

Did this solution work for you? Please pass it on!

Tweet

Other people are reading…

• How to stop users selecting text in a UIWebView or WKWebView
• How to check whether an iPhone or iPad is upside down or face up
• How to recolor UIImages using template images and withRenderingMode()
• How to find a touch's location in a view with location(in:)
• How to read a title from a UIPickerView using titleForRow

About the Swift Knowledge Base

This is part of the Swift Knowledge Base, a free, searchable collection of solutions for common iOS questions.