AFSubtitleNavigationItem

Example

To run the example project, clone the repo, and run pod install from the Example directory first.

Requirements

Requires iOS 9.0 or later.

Installation

AFSubtitleNavigationItem is available through CocoaPods. To install it, simply add the following line to your Podfile:

pod 'AFSubtitleNavigationItem'

Usage

Start by importing AFSubtitleNavigationItem in your AppDelegate

import AFSubtitleNavigationItem

In your viewController's viewDidLoad method write the below:

navigationItem.isSubtitleEnabled = true
navigationItem.titleLabel?.text = "Title"
navigationItem.subtitleLabel?.text = "Subtitle"

Make sure this view controller actually have a navigationController, i.e. it's not directly presented without being in a navigation controller stack. You can also your custom navigation item to your presented view controller and use AFSubtitleNavigationItem properties directly.

Appearance allover the app

You customize all your navigationItems allover the application be easily using the below code:

Customizing titles:

UINavigationItem.appearance.titleTextColor = .darkGray
UINavigationItem.appearance.titleTextFont = UIFont.systemFont(ofSize: 17, weight: .medium)
UINavigationItem.appearance.titleTextShadowColor = UIColor.black.withAlphaComponent(0.05)
UINavigationItem.appearance.titleTextShadowOffset = CGSize(width: 0.5, height: 0.5)

Customizing Subtitles:

UINavigationItem.appearance.subtitleTextColor = .darkGray
UINavigationItem.appearance.subtitleTextFont = UIFont.systemFont(ofSize: 13, weight: .thin)
UINavigationItem.appearance.subtitleTextShadowColor = UIColor.black.withAlphaComponent(0.05)
UINavigationItem.appearance.subtitleTextShadowOffset = CGSize(width: 1, height: 1)

Author

Ahmed Fathi, [email protected]

License

AFSubtitleNavigationItem is available under the MIT license. See the LICENSE file for more info.