How to give a UINavigationBar a background image: setBackgroundImage()

Paul Hudson    September 15th 2016    @twostraws

You can call setBackgroundImage() on any navigation bar, providing an image to use and the bar metrics you want it to affect, and you're done. Bar metrics left you specify what sizes of bars you want to change: should this by all bars, just phone-sized bars, or just phone-sized bars on landscape?

Here's an example that changes the navigation bar background image to a file called "navbar-background.png" (you'll want to change that!) across all device sizes:

let img = UIImage(named: "navbar-background")
navigationController?.navigationBar.setBackgroundImage(img, for: .default)

Available from iOS 5.0

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

Tweet

Other people are reading…

• How to respond to the device being shaken
• How to fix Auto Layout problems
• How to add a UIApplicationShortcutItem quick action for 3D Touch
• How to fix the error “Failed to instantiate the default view controller for UIMainStoryboardFile”
• How to force a UIView to redraw: setNeedsDisplay()

About the Swift Knowledge Base

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