Navigation Bar(iOS)

Navigation bars for iOS are implemented using the built-in UIKit component UINavigationBar, however they should be configured using the Thumbprint decorator method NavigationBar.configure(_:appearance:content:) to apply one of the standard Thumbprint navigation bar styles.

There are three standard navigation bar appearances. In addition, custom themes can be defined by calling the NavigationBar.Appearance constructor directly.

Default

Shadowless

Transparent

There are two standard content styles. The content style defines how foreground content such as text should be displayed.

Default

Dark content style to be used on a navigation bar with a light background.

Light

Light content style to be used on a navigation bar with a dark background.

var isTranslucent: Bool

var backgroundImage: UIImage?

var barTintColor: UIColor?

var shadowImage: UIImage?

var tintColor: UIColor??

If set to nil, will default to the content style’s foreground color. Set to .some(nil) to disable this default and actually set the navigation bar’s tint color to nil.

var titleTextAttributes: [NSAttributedString.Key: Any]?

If no foreground color is specified, will default to the content style’s foreground color.

var largeTitleTextAttributes: [NSAttributedString.Key: Any]?

If no foreground color is specified, will default to the content style’s foreground color.

public init(isTranslucent: Bool, backgroundImage: UIImage?, barTintColor: UIColor?, tintColor: UIColor??, shadowImage: UIImage?, titleTextAttributes: [NSAttributedString.Key: Any]?, largeTitleTextAttributes: [NSAttributedString.Key: Any]?)

public static let default: NavigationBar.Appearance

Default navigation bar appearance.

public static let shadowless: NavigationBar.Appearance

Navigation bar appearance without a bottom shadow.

public static let transparent: NavigationBar.Appearance

Transparent navigation bar appearance.

case default

Style for use on a light background.

case light

Style for use on a dark background.

var foregroundColor: UIColor

Color used for foreground content such as text and template icons.

public static func configure(_ navigationBar: UINavigationBar, appearance: Appearance = .default, content: ContentStyle = .default)

Configure a navigation bar with the specified appearance and content style.

Pass UINavigationBar.appearance() for the navigationBar argument to set the default appearance of all navigation bars.