iOS Navigation Bar Transition: Challenges and Solutions

In large iOS applications such as Meituan, existing open‑source navigation‑bar transition solutions are often insufficient. Hard‑coded approaches lead to high maintenance cost, coupling between modules, and poor scalability.

Understanding the Navigation Bar Architecture

The navigation bar follows an MVC‑like structure: UINavigationController acts as the Controller, UINavigationBar as the View, and the stack of UIViewController + UINavigationItem as the Model. Changing self.navigationItem properties updates the bar’s appearance.

Lifecycle and State Management

During push and pop operations, a series of methods are invoked (e.g., viewWillAppear:, viewWillDisappear:, viewWillLayoutSubviews, viewDidAppear:). The navigation bar’s state must be restored after each transition – the “who modifies, who restores” principle.

When to Change Styles

The ideal moments are viewWillAppear: and viewWillDisappear:. These callbacks correspond to the view’s appearance and disappearance phases and guarantee a smooth transition.

Common Style Changes

Show / hide the bar – use setNavigationBarHidden:animated: (never the non‑animated version).

Change background color – if translucent is YES, call setBackgroundColor:; otherwise use setBackgroundImage:forBarMetrics:.

Handle transparent, translucent, opaque, alpha and opacity correctly.

Three Typical Solutions

Custom navigation‑controller‑like container that manages bar styles.

Make the system bar transparent and add a fake bar inside each view controller.

During transition, add a fake bar, hide the real one, and swap styles at the end (Meituan’s choice).

Meituan’s Implementation

When pushing from A to B, a fake bar identical to the real one is added to A’s view and the real bar is hidden. B configures its own style in viewWillAppear:. Before B appears, the fake bar’s style is transferred to the real bar, the fake bar is removed, and the real bar becomes visible. The pop process mirrors this flow.

- (void)viewWillAppear:(BOOL)animated{
    [super viewWillAppear:animated];
    // MARK: change the navigation bar style
}

- (void)viewWillDisappear:(BOOL)animated{
    [super viewWillDisappear:animated];
    // MARK: restore the navigation bar style
}

Best Practices

All style changes should be placed in viewDidLoad or viewWillAppear:, never in viewWillDisappear:.

Avoid modifying the translucent property directly or indirectly.

When hiding the bar, always use setNavigationBarHidden:animated: with matching animation flags.

For transparent bars, set a blank background image and shadow image:

[self.navigationController.navigationBar setBackgroundImage:[UIImage new] forBarMetrics:UIBarMetricsDefault];
self.navigationController.navigationBar.shadowImage = [UIImage new];

Following these guidelines reduces coupling, prevents state leakage across view controllers, and ensures a stable navigation experience in large iOS projects.