Mastering UINavigationController: Push and Pop
The
UINavigationController
The Navigation Stack
Imagine a stack of plates. When you add a new plate, it goes on top. When you remove a plate, you take it from the top. The
UINavigationController
Pushing a view controller adds it to the top of the navigation stack.
When you want to navigate to a new screen, you 'push' a new view controller onto the navigation controller's stack. This action typically animates the new view controller sliding in from the right, and a back button appears in the navigation bar to allow the user to return to the previous screen.
To push a view controller, you instantiate the desired view controller and then call the pushViewController(_:animated:) method on the UINavigationController instance. The animated: parameter controls whether the transition is animated. For example:
let nextViewController = NextViewController()
navigationController?.pushViewController(nextViewController, animated: true)
This pushes nextViewController onto the stack and animates the transition. The UINavigationController automatically manages the back button in the navigation bar for the pushed view controller, provided it's not the root view controller.
Popping a view controller removes it from the top of the navigation stack.
When a user taps the back button or you programmatically decide to go back, you 'pop' the current view controller. This removes the top view controller from the stack, revealing the one below it, typically with a slide-out animation from the right.
The most common way to pop a view controller is by the user tapping the automatically provided back button. Programmatically, you can pop the top view controller using popViewController(animated:). This method removes the top view controller and returns it, allowing you to perform actions with it if needed.
navigationController?.popViewController(animated: true)
To pop to a specific view controller in the stack (not just the immediate previous one), you can use popToViewController(_:animated:). This method requires you to provide the specific view controller instance you want to return to.
if let specificVC = navigationController?.viewControllers.first(where: { $0 is SpecificViewController }) {
navigationController?.popToViewController(specificVC, animated: true)
}
Finally, popToRootViewController(animated:) will pop all view controllers except the first one, returning the user to the initial screen of the navigation stack.
pushViewController(_:animated:)
popViewController(animated:)
| Action | Method | Effect on Stack | Typical Animation |
|---|---|---|---|
| Navigate Forward | pushViewController(_:animated:) | Adds to top | Slides in from right |
| Navigate Back (one step) | popViewController(animated:) | Removes from top | Slides out to right |
| Navigate Back (to specific) | popToViewController(_:animated:) | Removes intermediate VCs | Slides out to right |
| Navigate Back (to root) | popToRootViewController(animated:) | Removes all but root | Slides out to right |
The UINavigationController manages a stack of UIViewController objects. When you push a new view controller, it's placed on top of the stack, and the previous view controller remains below it. When you pop a view controller, it's removed from the top, and the view controller that was previously beneath it becomes visible. This LIFO (Last-In, First-Out) structure is key to hierarchical navigation.
Text-based content
Library pages focus on text content
Remember that UINavigationController is a container view controller. It doesn't have its own visual representation in the same way a UIViewController does; instead, it manages the presentation of its child view controllers.
Interoperability with Swift and Objective-C
When working with mixed Swift and Objective-C projects,
UINavigationController
Learning Resources
The official and most authoritative source for understanding UINavigationController, its properties, and methods.
A comprehensive tutorial covering the basics of UINavigationController, including pushing and popping view controllers with practical examples.
A visual walkthrough demonstrating how to implement navigation controllers, push, and pop view controllers in Swift.
An insightful blog post explaining the concept of the navigation stack and how UINavigationController manages it.
While focused on SwiftUI, this article provides a good comparison and context for UIKit's UINavigationController.
A clear explanation of UINavigationController's role and basic usage in iOS development.
Direct link to the class reference, essential for detailed method signatures and property explanations.
A community-driven resource with common questions and answers regarding UINavigationController implementation.
A tutorial that covers transitions between view controllers, including the use of UINavigationController.
A concise guide from Hacking with Swift on setting up and using a navigation controller in UIKit projects.