How do I make my navigation bar scroll with a UITableView using AMScrollingNavbar?

Subclass ScrollingNavigationController and call followScrollView with your tableView in viewWillAppear, ensuring to stop following in viewDidDisappear. The README provides Swift and Objective-C examples for this setup.

AMScrollingNavbar vs. native iOS scroll behavior: which is better for hiding the nav bar?

AMScrollingNavbar offers more customization like delay and follower views, while native iOS scroll behavior is simpler but less flexible. Choose AMScrollingNavbar for polished, controllable animations in UIKit apps.

Can I use AMScrollingNavbar in a SwiftUI app?

Yes, but it requires bridging with UIViewControllerRepresentable since the library is UIKit-based. This adds complexity compared to using native SwiftUI solutions or waiting for SwiftUI-specific alternatives.

How to sync a custom toolbar with the navigation bar scrolling?

Add the toolbar as a follower in the followScrollView call, specifying the scroll direction (e.g., .scrollDown). The README details this with code snippets for proper implementation.

Why is my navigation bar not hiding when I scroll with AMScrollingNavbar?

Check that you've set the delay parameter correctly and called followScrollView in viewWillAppear. Ensure no other scroll delegates are interfering, and verify that the navigation controller is properly subclassed as ScrollingNavigationController.

Does AMScrollingNavbar support iOS 15's large title navigation bars?

The library may need adjustments for full compatibility with iOS 15 features like large titles, as it's built on older UIKit paradigms. Review the versioning notes and consider testing with sample projects.

Open-Awesome

AMScrollingNavbar

MITSwift5.3.0

A custom UINavigationController that enables the navigation bar to scroll alongside a UIScrollView in iOS apps.

GitHub

6.0k stars632 forks0 contributors

What is AMScrollingNavbar?

AMScrollingNavbar is a Swift library that creates a scrollable UINavigationBar that collapses and expands in sync with a UIScrollView, such as a UITableView or UICollectionView. It solves the problem of limited screen space in iOS apps by hiding the navigation bar as users scroll down and revealing it when they scroll up, similar to behaviors seen in apps like Safari or Twitter.

Target Audience

iOS developers building apps with scrollable content who want to implement dynamic navigation bar interactions to improve user experience and maximize content visibility.

Value Proposition

Developers choose AMScrollingNavbar because it provides a ready-to-use, customizable solution with smooth animations, support for follower views, and easy integration via CocoaPods or Carthage, saving time compared to building such functionality from scratch.

Overview

Scrollable UINavigationBar that follows the scrolling of a UIScrollView

Use Cases

Best For

Implementing collapsible navigation bars in table view or collection view based apps
Adding dynamic UI interactions similar to Safari's hideable address bar
Maximizing screen real estate in content-heavy iOS applications
Creating immersive reading or browsing experiences with minimal UI distractions
Syncing multiple UI elements (like toolbars) with navigation bar scrolling
Enhancing user experience in iOS apps with fluid, native-feeling scroll animations

Not Ideal For

Apps built entirely with SwiftUI that require seamless native integration without UIKit bridging
Projects with highly customized UINavigationController subclasses that conflict with ScrollingNavigationController
Teams needing automatic support for modern iOS features like large titles or inline search bars without additional work

Pros & Cons

Pros

Smooth Scroll Animations

Delivers native-feeling collapse and expand animations that enhance user experience, as demonstrated in the project's GIF screenshot.

Follower Views Syncing

Allows additional UI elements like toolbars or tab bars to move in sync with the navigation bar, maximizing screen real estate efficiently.

Customizable Scrolling Parameters

Provides control over delay, scroll speed factor, and additional offset for fine-tuning scrolling behavior to match specific app needs.

Backward Compatibility

Supports both Swift and Objective-C with maintained versions for different Swift syntax updates, easing migration and adoption.

Cons

Intrusive Subclassing Requirement

Forces the use of ScrollingNavigationController instead of standard UINavigationController, which can conflict with other custom navigation setups and increase integration complexity.

Manual Tint Color Updates

Requires calling navBarTintUpdated() after changing UINavigationBar.tintColor, adding unnecessary boilerplate and potential for visual bugs if forgotten.

Complex Navigation Handling

Demands careful implementation in viewWillDisappear to show the navbar and handle followers, increasing setup complexity and risk of errors.

Frequently Asked Questions

Related Projects

SkeletonView

☠️ An elegant way to show users that something is happening and also prepare them to which contents they are awaiting

Stars12,869

Forks1,127

Last commit16 days ago

Material

A UI/UX framework for creating beautiful applications.

Stars11,986

Forks1,257

Last commit3 years ago

NVActivityIndicatorView

A collection of awesome loading animations

Stars10,715

Forks1,156

Last commit1 month ago

Macaw

Powerful and easy-to-use vector graphics Swift library with SVG support

Stars6,049

Forks568

Last commit2 years ago

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub