How to integrate TONavigationBar with a UITableView?

Set the target scroll view in viewWillAppear using setTargetScrollView, and ensure your view controller is a child of the UINavigationController stack, as shown in the basic implementation example. This automatically coordinates the navigation bar transparency with table view scrolling.

TONavigationBar vs HidingNavigationBar: which should I use?

TONavigationBar is better for replicating Apple's specific Music/TV app style safely without private APIs, while HidingNavigationBar might offer more general hiding features. TONavigationBar integrates more seamlessly with UINavigationController but has iOS version and maintenance trade-offs.

Can TONavigationBar work with collection views?

Yes, it can target any UIScrollView, including UICollectionView, by setting the target scroll view in the navigation bar. This allows the transparency effect to sync with collection view scrolling, similar to table views.

How to handle dark mode with TONavigationBar?

It automatically supports light and dark themes through iOS's system settings, as mentioned in the features. Ensure your app's UI adapts, and the navigation bar will adjust its appearance accordingly without extra code.

What happens if iOS updates break the view traversal?

According to the README, the worst-case scenario is the title label remains always visible, but the core transparency functionality should persist since it uses public APIs. However, you may need to update the library or fork it for fixes.

How to add a custom header image with TONavigationBar?

Use the included TOHeaderImageView component: instantiate it with an image and height, set it as the tableHeaderView, and update its scrollOffset in scrollViewDidScroll, as demonstrated in the README example for banner headers.

Open-Awesome

TONavigationBar

MITObjective-C

A UINavigationBar subclass that replicates the iOS 12 Apple TV app's transparent, scroll-responsive navigation bar style.

GitHub

251 stars24 forks0 contributors

What is TONavigationBar?

TONavigationBar is an open-source iOS library that provides a UINavigationBar subclass capable of replicating the transparent, scroll-responsive navigation bar style used in Apple's modern iOS apps like Music and TV. It solves the problem of Apple not providing public APIs to achieve this specific visual effect, allowing developers to create similar immersive interfaces in their own apps.

Target Audience

iOS developers building apps that require modern, immersive navigation interfaces similar to Apple's Music or TV apps, particularly those needing transparent navigation bars that respond to scrolling.

Value Proposition

Developers choose TONavigationBar because it provides a safe, App Store-compliant way to achieve a popular Apple UI pattern without using private APIs, integrates seamlessly with UINavigationController, and includes companion components like TOHeaderImageView for complete implementation.

Overview

Replicating the 'clear' navigation bar style of the iOS 12 Apple TV app.

Use Cases

Best For

Implementing Apple Music-style transparent navigation bars
Creating immersive scrolling interfaces with dynamic navigation bars
Building iOS apps with modern Apple TV app aesthetics
Adding scroll-responsive UI elements to table or collection views
Developing iOS apps that need light/dark theme compatible navigation
Creating banner headers that coordinate with navigation bar transparency

Not Ideal For

Projects built entirely with SwiftUI needing native navigation components
Apps that must support iOS versions earlier than 11.0
Teams averse to maintenance risks from internal view hierarchy traversal
Applications requiring highly customizable navigation bars beyond transparency effects

Pros & Cons

Pros

Seamless UINavigationController Integration

Fully integrates with UINavigationController and supports swipe-to-go-back gestures, as highlighted in the README, ensuring a native feel without disrupting navigation flow.

Automatic Scroll Coordination

Allows targeting a UIScrollView to automatically sync background visibility with scroll position, reducing manual code for scroll-responsive UI, per the features list.

Light/Dark Theme Support

Compatible with both light and dark themed iOS apps, enabling consistent aesthetics across system settings without extra configuration.

App Store Safe Implementation

Avoids private API calls by using public methods and custom reimplementation, as the README confirms, minimizing rejection risks while achieving the desired effect.

Cons

Reliance on Internal View Traversal

Uses view hierarchy traversal to find the title label, which the README admits is 'a terrible way to go' and may break in future iOS versions, requiring maintenance.

iOS Version Limitation

Requires iOS 11.0 or above, excluding support for older devices and apps that need broader compatibility, as specified in the system requirements.

UIKit-Only Dependency

Tied to UIKit and does not support SwiftUI, making it less suitable for modern iOS projects adopting Apple's newer UI frameworks.

Frequently Asked Questions

Related Projects

AMScrollingNavbar

Scrollable UINavigationBar that follows the scrolling of a UIScrollView

Stars5,992

Forks628

Last commit3 years ago

LTNavigationBar

UINavigationBar Category which allows you to change its appearance dynamically

Stars4,419

Forks668

Last commit8 years ago

KMNavigationBarTransition

A drop-in universal library helps you to manage the navigation bar styles and makes transition animations smooth between different navigation bar styles while pushing or popping a view controller for all orientations. And you don't need to write any line of code for it, it all happens automatically.

Stars3,346

Forks445

Last commit2 years ago

HidingNavigationBar

Easily hide and show a view controller's navigation bar (and tab bar) as a user scrolls

Stars1,034

Forks125

Last commit4 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