关于UINavigationContrller官方文档翻译

/**
 
        ******   关于UINavigationContrller官方文档翻译    *****
 UINavigationController
 继承于：UIViewController : UIResponder : NSObject
 遵守协议：UIAppearanceContainer, UIContentContainer, NSCoding, NSObject, UITraitEnvironment
 基于框架：UIKit in iOS 2.0 and later.
 
 
 这个UINavigationController类是专门提供与一个同等级的UIViewController
 管理的“导航控制器”， 这个导航控制器使我们更方便的管理和呈现所要呈现的数据，
 你也可以根据自己的需求，自定义一个继承与UINavigationController的导航控制器
 
 手机屏幕的呈现是由导航控制器效仿等级机构的机制来呈现数据的，在每一个层次上，你
 可以提供自定义的视图（自定义的控制器管理）来呈现在这个层次视图上，以下是关于
 UINavigationController呈现视图的一个例子。
 Figure 1（来自于模拟器的Settings）
 
 图片地址：file:///Users/iphone5solo/Library/Developer/Shared/Documentation/DocSets/com.apple.adc.documentation.iOS.docset/Contents/Resources/Documents/documentation/UIKit/Reference/UINavigationController_Class/Art/navigation_interface_2x.png
 
 
 导航控制器管理当前呈现的视图（screen）是通过使用，堆栈中的栈方式（Navigation stack）
 管理（先进后出) 存储在导航控制器的viewControllers(NSArray)中；在数组中
 的第一个控制器是根控制器，最上面的控制器就是当前呈现的控制器，你可以通过segues或者使用相关方法来添加或者移除控制器，使用者可以使用navigation bar 上“返回”按钮 或者 手势来关闭
 最上面的控制器。
 
 导航控制器也管理着屏幕上端的导航条（navigation bar）和屏幕底部的选择工具条（optional toolbar）,导航条的delegate就是当前的导航控制器，当你切换控制器时，导航条会一直呈现在屏幕（只要你不隐藏它），工具条会根据当前显示的控制器相应地调整选中的按钮）。
 
 导航控制器有自己的代理，用来push或者pop viewController,但代理必须遵守 UINavigationControllerDelegate 协议
 下面是展示导航控制器管理的类的联系
 Figure 2 Objects managed by the navigation contrller
 
 图片地址： file:///Users/iphone5solo/Library/Developer/Shared/Documentation/DocSets/com.apple.adc.documentation.iOS.docset/Contents/Resources/Documents/documentation/UIKit/Reference/UINavigationController_Class/Art/nav_controllers_objects.jpg
 
 Navigation Controller Views
 
 导航控制器实际上是容纳控制器（view controller）的容器，它里面嵌入了其他（view controllers ）的内容，你获取导航控制器的一个控制器（view contrller）这个view就会
 自动合并导航条，工具条，以及最上面的控制器。 Figure 3 呈现了这些views如何装配然后全部呈现
 到屏幕上的，在这个实例，这个导航控制器的视图嵌入最深，所以无论导航条和工具条
 视图如何改变，它都不会改变，自动改变的视图是在（navigation statc）最上面的控制器。
 Figure 3 The view of a navigation controller
 
 
图片地址： file:///Users/iphone5solo/Library/Developer/Shared/Documentation/DocSets/com.apple.adc.documentation.iOS.docset/Contents/Resources/Documents/documentation/UIKit/Reference/UINavigationController_Class/Art/NavigationViews_2x.png
 
 注意：因为这个内容视图是基于这个导航条（iOS 7 and later），当你自定义你的view controller时，你必须考虑一下这个空间布局。
 
 导航控制器在管理它的子控件时，会尽可能的调整导航条的布局，但你不能直接改变导航条的frame,bouns, alpha的值。如果你继承了UINavigationBar， 你必须实例化你的导航控制器 使用initWithNavigationBarClass:toolbarClass: 这个方法，如果要隐藏导航条，使用e navigationBarHidden 属性，或者setNavigationBarHidden:animated:方法
 
 导航控制器在创建导航条时，会使用navigation item的对象来联系（navigation stack）各个控制器，使用UIAppearance APIs来定做导航条，为了改变导航条里面的内容，你必须在你自定义的
 控制器中配置navigation items。
 
 
 Updating the Navigation Bar
 
 每当最上层的控制器改变，导航控制器就会相应地更新导航条。具体来说，导航控制器会更新导航条的
 左、中、右三个地方的bar button item, 每一个Bar Button items 是UIBarButtonItem 实例化的对象，你可以根据你的需求创建自定义的items或者系统标准的items.
 
导航条的字体是由导航条自己管理的，使用tintColor属性改变导航条内的items字体颜色，使用barTintColor属性改变当行条自身字体颜色。
 导航条字体的颜色不能从当前控制器继承。更多关于导航条的信息，请看 *UINavigationBar Class Reference* 更多关于如何关键
 bar button items, 请看 *UIBarButtionItem Class Reference*.
 
 The Left Item
 对于所有的导航控制器的根控制器，这个左边的item提供了一个返回到上一个控制器的功能
 （下一个控制器的返回按钮默认是上一个控制器的backBarButtonItem属性）。
 左边的item的内容必须遵守如下规则：
 
 * 如果最上面的控制器有自定义的bar button item并导航条就会呈现它。
 * 如果最上面的控制器没有自定义的bar button item, 但上一个控制器有backBarButtonItem
 属性, 导航条就会现在上一个控制器的backBarButtonItem。
 * 如果一个自定义的bar button item 在前后两个控制器都没有详细配置时，默认返回按钮上的标
 题为前一个控制器的主标题，如果在navigation stack中只有一个控制器，返回按钮不会被呈现。
 
 注意：万一一个返回按钮的标题超过了当前的可用空间，导航条就会调整返回按钮的实际标题为
 “back”（这个情况只有这个返回按钮是由上一个控制器的backBarButtonItem创建的）,如果最
 上面的控制器的返回按钮是自定义的一个leftBarButtonItem or leftBarButtonItems 对象，
 就算是navigation item的私有item,导航条不能改变器按钮标题。


 
 The Middle Item
 中间Item的更新必须遵守以下规则：
 * 如果最上面的控制器有一个自定义的title view, 导航条会在默认的地方呈现它，为了详细设置
 自定义的title view， 需要在当前控制器的navigation item中设置titleView.
 
 * 如果没有创建自定义的title view， 导航条默认会呈现一个包含label的title view，label
 上显示的通常是这个控制器的标题，如果你想要修改标题，你可以修改该控制器的navigation item 
 的title属性。
 
 The Rgiht Item
 右边Item的更新必须遵守以下规则：
 * 如果最上面的控制器有自定义的right bar button item， 导航条就会呈现它。
 可以通过设置控制器的navigation item的rightBarButtonItem属性来配置它。
 * 如果没有具体配置的right bar button item，导航条就不会呈现它
 
 Displaying a Toolbar
 导航控制器在它的view 体系里管理可选择的工具条，当呈现工具条时，工具条包含着当active（活
 跃）控制器的toolbarItems属性的items；当active view controller改变是，
 导航控制器就会更新工具条的items到合适的位置来搭配新的控制器。
 
 默认情况下，toolbar是隐藏的，如果需要显示可以通过控制器的navigation controller 调用
 setToolbarHidden:animated:方法叫出工具条，如果不是所有的控制器支持toolbar items
 在push和pop操作之后，你的代理可以使用这个方法来切换工具条的能见度。为了能使用一个自定义的
 工具条， 在实例化导航控制器的使用initWithNavigationBarClass:toolbarClass:方法。
 如果你使用自定义的工具条和导航条来创建导航控制器，注意在屏幕呈现导航控制器前负责push和
 设置view controllers.
 
 Adapting to Different Environments（适用不同的环境）


 导航界面在horizontally compact 和 horizontally regular环节中仍然相同。当在这两种
 环境切换界面时，只有导航控制器的view的大小会改变，导航控制器不会改变填的view等级
 或者它的views的布局。
 当配置sugues在两个view controllers（在同一个navigation stack中）,这个标准的Show h
 和 Show Detail segues的行为如下：
 * Show segue - 控制器push这个具体说明（自定义）进入它的navigation stack
 * Show Detail segue - 控制器present这个具体说明（自定义）呈现出来（相当于modal）
 这些行为在其他segue（不在同一个导航控制器的栈中的两个view controller）是没有改变的。
 
 
 Interface Beahavious
 一个导航控制器支持以下的行为在它的界面：
 * Supported interface orientations - 导航控制器对象在确定支持的界面方向时，不能在其导航堆栈上查询视图控制器， 在iPhone中，导航控制器支持所有的视图，除了portrait 
 upside-down（颠倒）. 在 iPad, 导航控制器支持所有的视图，如果导航控制器有代理。这个代理
 可以具体说明一个不同的支持视图的设置通过使用
 navigationControllerSupportedInterfaceOrientations:方法
 
* Presentation context - 一个导航控制器描绘出一个外观通过madal呈现出view 
 controller,当madal的转换方式为UIModalPresentationCurrentContext or 
 UIModalPresentationOverCurrentContext, 从view controller（在navigation 
 stack）模态视图将覆盖导航控制器的界面。
 
 
Creating Navigation Controllers
 
 
//  实例化一个导航控制器对象
 - (instancetype _Nonnull)initWithRootViewController:(UIViewController * _Nonnull)rootViewController
 
// 实例化一个带有导航条，和工具条的导航控制器对象
 - (instancetype _Nonnull)initWithNavigationBarClass:(Class _Nullable)navigationBarClass
 toolbarClass:(Class _Nullable)toolbarClass
 
 属性
 * topViewController 最顶部的控制器，当前可见的控制器
 * visibleViewController 与当前课件视图相关联的控制器
 * viewControllers （NSArray）当前导航控制器的堆栈中的控制器
 
 // 替代当前堆栈中的控制器
 - (void)setViewControllers:(NSArray<UIViewController *> * _Nonnull)viewControllers
 animated:(BOOL)animated
 
 // 推送一个新的控制器进入导航控制器的导航堆栈中，此控制器成为最上面的控制器， 新的控制器的view嵌入导航控制器的界面
 - (void)pushViewController:(UIViewController * _Nonnull)viewController
 animated:(BOOL)animated
 
 // 推出最上面的控制器，从堆栈中移除控制器，如果对根控制器使用这个方法，将上面也不做
 - (UIViewController * _Nullable)popViewControllerAnimated:(BOOL)animated
 
 // 把所有的控制器都推送出去（移除）除了根控制器，剩下根控制器
 - (NSArray<__kindofUIViewController *> * _Nullable)popToRootViewControllerAnimated:(BOOL)animated
 
 // 把压在指定的控制器上面的控制器都推出，使之成为最上面的控制器
 - (NSArray<__kindofUIViewController *> * _Nullable)popToViewController:(UIViewController * _Nonnull)viewController
 animated:(BOOL)animated


 属性
 * interactivePopGestureRecognizer // 手势向右滑来pop
 
 
 
Configuring Navigation Bars
 
 属性
 * navigationBar 导航条，由导航控制器管理
 * navigationBaeHidden 是否隐藏导航条
 // 是否隐藏控制器
 - (void)setNavigationBarHidden:(BOOL)hidden animated:(BOOL)animated
 
Configuring Custom Toolbars
 
 属性
 * toolbar 工具条 由导航控制器管理
 * toolbarHidden  是否隐藏工具条
 *  hidesBottomBarWhenPushed 当push是否隐藏工具条
 
 // 通过在堆栈中的控制器的navigation controller来设置我们的工具条
 setToolbarItems:animated:
 // 是否隐藏工具条
 - (void)setToolbarHidden:(BOOL)hidden animated:(BOOL)animated


 Hiding the Navigation Bar
 
 属性
 * hidesBaesOnTap // 使用tap手势隐藏导航条 默认为NO
 * hidesBarsOnSwipe // 使用swipe手势隐藏导航条 默认为NO
 * hidesBarsWhenVerticallyCompact // 在 vertically compact environment环境隐藏导航条
 默认为NO
 * hidesBarsWhenKeyboardAppears // 当键盘弹出时，隐藏导航条 默认为NO
 * navigationBarHidden // 隐藏导航条 默认为NO
 // 动态隐藏导航条
 setNavigationBarHidden:animated:
 
 * barHideOnTapGestureRecognizer // 通过tap手势显示和隐藏导航条、工具条
 * barHideOnSwipeGestureRecognizer // 通过swipe手势显示和隐藏导航条、工具条
 
Action Method for Displaying View Controllers
 // 呈现出指定的控制器到导航控制器界面上
 - showViewController:sender: 该方法和 pushViewController:animated:相似


 */