UISplitViewController 是一个容器vc, 展示一个 master-detail(主-详(从))界面。
主视图改变会驱动从视图的改变。两个视图可用同时展示,也可以只显示一个。当创建app界面的时候,UISplitViewController通常是root vc ,它没有自己的元素可展示,它展示的是它的子vc,可通过属viewControllers来设置。
1. 主要属性及方法
(1)分隔视图的期望展示方式
@available(iOS 8.0, *)
public enum UISplitViewControllerDisplayMode : Int {
// 自适应模式,splitViewController会为可用空间选用合适的展示视图方式,在ipad的竖直方向会用. primaryOverlay模式展示视图,在iPad水平方向将会用. allVisible 模式展示。
case automatic
// 主视图隐藏
case primaryHidden
// 主详视图都显示
case allVisible
// 主视图部分覆盖详细视图
case primaryOverlay
}
...
open var preferredDisplayMode: UISplitViewControllerDisplayMode
typedef NS_ENUM(NSInteger, UISplitViewControllerDisplayMode) {
UISplitViewControllerDisplayModeAutomatic,
UISplitViewControllerDisplayModePrimaryHidden,
UISplitViewControllerDisplayModeAllVisible,
UISplitViewControllerDisplayModePrimaryOverlay,
} NS_ENUM_AVAILABLE_IOS(8_0);
...
@property (nonatomic) UISplitViewControllerDisplayMode preferredDisplayMode NS_AVAILABLE_IOS(8_0);
(2)diplayModeButtonItem: UIBarButtonItem - 改变分隔视图显示模式的按钮
如果想显示的更改分隔视图的显示模式,那么在界面中应该包含这个按钮。点击此按钮,通过deletage的方法
optional public func targetDisplayModeForAction(in svc: UISplitViewController) -> UISplitViewControllerDisplayMode
最后返回的值来改变分隔视图的显示模式。
(3)presentsWithGesture: Bool - 指定一个隐藏的视图控制器是否可以使用一个滑动手势来呈现和退出。
此属性针对iphone6s plus横屏及ipad有效,即是针对 size class 为(w:Regular)或则(height:Regular)的情况。当它的属性为true的时候,splitViewController 会添加一个手势识别器,通过delegete的方法optional public func targetDisplayModeForAction(in svc: UISplitViewController) -> UISplitViewControllerDisplayMode
返回的显示模式,来改变splitViewController的当前显示模式。如果设置为false则手势无效。
使用手势:
禁用手势:
(4)viewControllers: [ UIViewController ] - 管理的视图控制器
当分隔视图界面展开的时候,此属性包括两个vc,当它折叠的时候,此属性包含一个vc。 数组中第一个元素称为
primary(或 master)vc, 如果第二个元素呈现,那么它称为secondary(或 detail)vc。
可以用此属性初始化splitViewController,但当splitViewController已经显示的时候,最好用 open func show(_ vc: UIViewController, sender: Any?)
或者open func showDetailViewController(_ vc: UIViewController, sender: Any?)
来设置子vc。
override func viewDidAppear(_ animated: Bool) {
super.viewDidAppear(animated)
// 从 storyboard初始化一个vc
let vc = storyboard?.instantiateViewController(withIdentifier: "detailVC") as! DetailViewController
self.showDetailViewController(vc, sender: self )
}
(5)showDetailViewController - 显示详细视图
此方法会调用delegate的方法optional public func splitViewController(_ splitViewController: UISplitViewController, showDetail vc: UIViewController, sender: Any?) -> Bool
,给delegate一个显示vc的机会。如果delegate不想显示,那么 splitViewController会向前发送消息到将要被替换的vc,看看这个vc有什么要做的。例如:导航控制器会把vc放入它的导航栈中。如果没有任何对象想显示vc,那么splitViewController按照如下方法安排vc的显示:
- 在水平正常环境(w:Regular), vc作为detail vc展示。
- 在水平紧凑环境(w:Compact),vc以modally方式展示。
(6)delegate: UISplitViewControllerDelegate? - 代理
协议定义了一个方法可以让你管理一个拆分视图界面的变化。使用此协议的方法来响应当前显示模式和当前界面方向的变化。当拆分视图界面折叠和展开时,或当一个新的视图控制器被添加到界面时,您还可以使用这些方法来适当地配置子视图控制器。
主要方法如下:
// 当视图转换到折叠模式,通常只显示主视图,通过此方法可以定制主视图。
optional public func primaryViewController(forCollapsing splitViewController: UISplitViewController) -> UIViewController?
// 视图转换为折叠模式,可用实现此方法为主视图进行一些处理,或者尝试把详细视图的内容包含进新的折叠视图。
// 此方法会回后,splitViewController会把详细视图vc从 ‘viewControllers’ 属性中移除。 返回false表示splitViewController采用默认的方式尝试在折叠视图中包含 ‘detail vc’,同时也会调用
// master vc 的方法‘collapseSecondaryViewController:forSplitViewController:’对 ‘detail vc’对内容做一些处理,大部分控制器什么也不做,但当是‘UINavigationController’对时候会把
‘detail vc’放入到导航堆栈中。 返回true,表示什么也不做。
optional public func splitViewController(_ splitViewController: UISplitViewController, collapseSecondary secondaryViewController: UIViewController, onto primaryViewController: UIViewController) -> Bool
// 当从水平紧凑变为水平正常模式时,调用此方法返回主控制器用来显示,可用返回特定的vc,如果返回nil将使用当前的主控制器。
optional public func primaryViewController(forExpanding splitViewController: UISplitViewController) -> UIViewController?
//为拆分视图返回详细视图控制器,如果返回为nil,splitViewController将会调用主控制的方法:
separateSecondaryViewControllerForSplitViewController:来返回一个合适的vc,
// 大部分控制器默认什么也不做,但当是UINavigationController的时候会返回导航栈顶端的元素。
optional public func splitViewController(_ splitViewController: UISplitViewController, separateSecondaryFrom primaryViewController: UIViewController) -> UIViewController?