UISplirViewController-分屏视图控制器

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?
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 203,362评论 5 477
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,330评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,247评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,560评论 1 273
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,580评论 5 365
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,569评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,929评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,587评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,840评论 1 297
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,596评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,678评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,366评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,945评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,929评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,165评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 43,271评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,403评论 2 342

推荐阅读更多精彩内容