容器視圖控制器(Container View Controller)是一種把多個視圖控制器的內容整合到單一用戶界面上的方式。它常被用來讓導航更順暢,或基於既有內容創造全新的界面類型。UIKit 中典型的容器視圖控制器包括 UINavigationController、UITabBarController 與 UISplitViewController,它們都能讓用戶在不同視圖部分之間切換與導航更加便利。
幾乎在各方面,容器視圖控制器就像其他內容視圖控制器一樣,管理一個根視圖與一些內容。差別在於,容器視圖控制器會從其他視圖控制器那裡取得一部分內容,這些內容被侷限在其他視圖控制器的視圖裡,並內嵌於容器自己的視圖層次中。容器負責為內嵌視圖設定大小與位置,但原本的視圖控制器仍舊管理這些視圖裡的內容。
設計自己的容器視圖控制器時,應該時刻理解 container 與 contained 之間的關係。在動手前,不妨先問自己這幾個問題:
一旦定義好各物件之間的規則,實作一個容器視圖控制器就相當簡單了。UIKit 唯一的硬性要求是:你需要在容器與它的任一子視圖控制器之間建立正式的 parent-child 關係,以確保 children 能收到系統發來的相關資訊。其餘大多數工作都落在布局與管理所包含的視圖上,而每個容器在這點上各不相同。
UINavigationController 透過分層的資料設定來支援導航,一次呈現一個子視圖控制器。界面頂部的導航條展示當前在資料層次中的位置,並提供後退按鈕回到上一層。導航的下降由子視圖控制器決定,通常會用到 table 與 button。
視圖控制器之間的導航由導航控制器與它的 children 共同管理:當用戶透過子視圖控制器的按鈕或 table 行進行互動時,子視圖控制器要求導航控制器推送一個新的視圖控制器,前者負責配置新內容,後者則負責管理過渡動畫與導航條。
絕大多數的內容區域被最上層的子視圖控制器填滿,導航條僅佔據很小一部分。

UISplitViewController 以主從排列展示兩個視圖控制器的內容,其中主視圖決定另一個視圖顯示的細節。在水平的 regular 環境中,兩者可並排顯示,也能隱藏主視圖並在需要時再顯示;在 compact 環境中,則一次僅顯示一個。

若要在設計時建立 parent-child 關係,可以添加一個容器視圖物件到 storyboard 上作為佔位符,代表子視圖控制器的內容。當你為容器視圖載入視圖控制器時,Interface Builder 也會載入相關的子視圖控制器,兩者會被同時初始化以建立正確的關係。

要實作容器視圖控制器,必須先在視圖控制器與它的子視圖控制器之間建立關係。在試著管理視圖之前,建立這種 parent-child 關係是必須的,這樣 UIKit 才知道你的視圖控制器正在管理子視圖的大小與位置。
以程式碼方式包含子視圖控制器時,可遵循以下步驟:
addChildViewController:,告訴 UIKit 你正在管理該子視圖控制器。didMoveToParentViewController:。- (void)displayContentController:(UIViewController *)content {
[self addChildViewController:content];
content.view.frame = [self frameForContentController];
[self.view addSubview:content.view];
[content didMoveToParentViewController:self];
}
注意,這裡只需呼叫 child 的 didMoveToParentViewController:,因為 addChildViewController: 已為你呼叫了 willMoveToParentViewController:。之所以要自己呼叫前者,是因為它必須在 child 的視圖被嵌入容器層次之後才能執行。
使用自動布局時,應在加入子視圖後於容器與 child 之間建立約束,且約束只應影響 child 根視圖的大小與位置,不能改動 child 視圖層次中的其他內容。
willMoveToParentViewController: 並傳入 nil。removeFromParentViewController 結束關係。- (void)hideContentController:(UIViewController *)content {
[content willMoveToParentViewController:nil];
[content.view removeFromSuperview];
[content removeFromParentViewController];
}
移除子視圖控制器會永久切斷 child 與 parent 的聯繫,因此只在你不再需要它時才移除。例如導航控制器在 push 新視圖控制器時,並不會移除目前的子視圖控制器,只有在它被 pop 出導航堆疊時才會移除。
若想以動畫讓一個子視圖控制器替換另一個,應在動畫過程中同時加入新控制器、移除舊控制器。動畫前確保兩者都是容器內容的一部分並讓舊者知道自己即將離開;動畫期間移動新視圖並移走舊視圖;動畫結束後完成移除。使用 transitionFromViewController:toViewController:duration:options:animations:completion: 時,系統會自動更新視圖層次,不需手動增刪。
加入子視圖控制器後,容器會自動把外觀相關資訊轉發給它,這通常是理想的行為。但有時預設順序對容器而言並不合理,例如多個 children 同時改變視圖狀態時,你可能希望合併這些回調、讓它們以更合理的順序發生。此時可在容器中重寫 shouldAutomaticallyForwardAppearanceMethods 並回傳 NO:
- (BOOL)shouldAutomaticallyForwardAppearanceMethods {
return NO;
}
接管責任後,就要視情況呼叫子視圖控制器的 beginAppearanceTransition:animated: 與 endAppearanceTransition:
-(void)viewWillAppear:(BOOL)animated {
[self.child beginAppearanceTransition:YES animated:animated];
}
-(void)viewDidAppear:(BOOL)animated {
[self.child endAppearanceTransition];
}
-(void)viewWillDisappear:(BOOL)animated {
[self.child beginAppearanceTransition:NO animated:animated];
}
-(void)viewDidDisappear:(BOOL)animated {
[self.child endAppearanceTransition];
}
容器作為一個整體相當複雜,即使個別行為直截了當。實作時可以參考以下建議:
view 屬性回傳的那個視圖,切勿碰其他視圖。容器視圖控制器可以把自身外觀的某些方面委託給子視圖控制器,方法包括:
childViewControllerForStatusBarStyle 與 childViewControllerForStatusBarHidden。preferredContentSize 屬性來決定大小。