NEW: Master Swift design patterns with my latest book! >>

How to create a marching ants effect using lineDashPhase

Written by Paul Hudson    @twostraws

“Marching ants” is the informal name used for animation of a selection: you see a dashed line around whatever you selected, and the dashes slowly move around the selection to show that it’s active.

iOS can achieve most of this effect for you when you’re using a CAShapeLayer. To try it out, first create a shape layer with a dashed stroke like this:

let layer = CAShapeLayer()
let bounds = CGRect(x: 50, y: 50, width: 250, height: 250)
layer.path = UIBezierPath(roundedRect: bounds, byRoundingCorners: .allCorners, cornerRadii: CGSize(width: 20, height: 20)).cgPath
layer.strokeColor = UIColor.black.cgColor
layer.fillColor = nil
layer.lineDashPattern = [8, 6]
view.layer.addSublayer(layer)

Now you need to create a CABasicAnimation to animate the lineDashPhase property. Annoyingly, the lineDashPattern – the part that describes the way the dashed are drawn – is actually an array of NSNumber so we need to boil it down to an integer with code like this:

animation.toValue = layer.lineDashPattern?.reduce(0) { $0 - $1.intValue } ?? 0

With the line dash pattern used above – 8, 6 – that will result in toValue being set to 14.

Here’s the animation you need to give the above shape layer a marching ants effect:

let animation = CABasicAnimation(keyPath: "lineDashPhase")
animation.fromValue = 0
animation.toValue = layer.lineDashPattern?.reduce(0) { $0 - $1.intValue } ?? 0
animation.duration = 1
animation.repeatCount = .infinity
layer.add(animation, forKey: "line")

I used .infinity for the repeat count so that it lasts forever.

Available from iOS 3.2

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

Other people are reading…

About the Swift Knowledge Base

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

Master iOS 11 now!

My book Practical iOS 11 gives you seven complete coding projects that teach all the major new features in iOS 11 in a smart, practical way.

Click here to visit the Hacking with Swift store >>