UINavigationItem

UINavigationItem是管理展示在navigation bar 对象上的按钮和视图的对象。

OverView

当搭建导航界面时，每一个push进导航控制器栈中的控制器必须有一个 包含想要展示在navigation Bar上的按钮和视图 的UINavigationItem对象。管理UINavigationController对象使用最顶层的两个视图控制器的导航项来填充导航栏的内容。

NavigationItem对象会反应其关联的视图控制器的信息。当视图控制器在导航栈中的最顶部时，NavigationItem对象必须提供一个展示的标题。另外，navigationItem可能包含其他的展示在navigation Bar 右侧的按钮。你也可以使用 leftBarButtonItems属性来指定展示在navigation Bar左侧的按钮和视图，需要注意的是，导航控制器只有在有足够展示空间的时候才会展示。

navigation Item对象的 backBarButtonItem属性关联的是当 当前视图控制器在导航控制器栈中最顶层控制器底部时 需要展示的返回按钮。也就是说，返回按钮不是当当前视图控制器在栈最顶部时使用的，而是在栈中从上往下数第二层时使用。

当给navigationItem指定按钮时，必须使用UIBarButtonItem对象。如果想给navigation Bar对象添加自定义的视图，必须在添加之前将这些视图包裹进UIBarButtonItem对象中。

Topics

Initializing an Item

init(title: String)

返回一个指定标题的navigationItem对象
init?(coder: NSCoder)

Configuring the Title

var title: String?

展示在navigation Bar上的navigation Item的标题

var largeTitleDisplayMode: UINavigationItem.LargeTitleDisplayMode

展示Navigation Bar上标题的模式

enum UINavigationItem.LargeTitleDisplayMode

如何计算该navigationItem的标题尺寸的常量

Getting and Setting Properties

var prompt: String?

展示在navigationBar顶部的一行文字

var backBarButtonItem: UIBarButtonItem?

是一个当navigaionBar需要一个返回按钮时的 UIBarButtonItem对象

var hidesBackButton: Bool

决定返回按钮是否隐藏的布尔值

func setHidesBackButton(Bool, animated: Bool)

设置是否需要隐藏返回按钮，是否需要过渡动画

var leftItemsSupplementBackButton: Bool
一个决定除了返回按钮之外是否还要展示其他左侧导航项的布尔值