AMScrollingNavbar

Today we are going to have a look at a “do only one thing but do it well” UI library. And as with most UI libraries a picture is better than a 1000 description words:

AMScrollingNavBar is made by Andrea Mazzini, one of the most prolific open source authors in our community.

This UI effect is most useful in applications presenting long scrolling content that is more important than the navigation bar buttons.

How to integrate AMScrollingNavbar

Adopting this fancy navigation bar behaviour in your app is very simple, there are only two steps required.

Firstly you need to make the navigation controller a subclass of ScrollingNavigationController, here’s how to do it in a Storyboard:

The second step consist in configuring the scrolling behaviour at the view controller level:

override func viewDidLoad() {
	super.viewDidLoad()

	if let navigationController = self.navigationController as? ScrollingNavigationController {
		navigationController.followScrollView(tableView, delay: 50.0)
	}
}

As easy as that 😎.

How to react to the navigation bar changes

If you need to perform some custom logic when the navigation bar changes state you can conform to ScrollingNavigationControllerDelegate:

extension ViewController: ScrollingNavigationControllerDelegate {
  print("Merry Christmas")
}

Next Steps

AMScrollingNavbar is another great example of small and sharp focused library, a trend that is becoming more and more common in Swift and that will definitely result in code that is easier to compose and maintain.

This library is also a great example of how documentation should be written, and how to use Swift’s access level to your advantage.

Head over to the project repository on GitHub to read the code and find out more ways to configure AMScrollingNavbar, or jump to this tutorial’s companion project to get your hands dirty in the code.

That’s it for today. See you tomorrow with a library that will help you when writing unit tests. Subscribe to the email list to avoid missing out.

If you found this post useful and want to support the Advent Calendar please consider sharing it on your favourite social network using the buttons below. Thanks 🎅