文章目錄
Storyboard 自 iOS 5 問世以來經歷了大量升級:反向 Segue、iPhone 與 iPad 共用設計、以及代碼與界面並存的設計流程等等。Xcode 7 又帶來三項新能力:
本文以一個名為「安然(Checklists)」的清單 App 為例,演示故事板引用與場景碼頭的用法。閱讀前最好具備基本的 storyboard 與表視圖知識。

下載初始專案並在模擬器中運行:點擊清單可查看其中項目,再點任意條目可查看詳情。

先熟悉一下代碼結構:ChecklistsViewController.swift 顯示清單列表,ChecklistDetailViewController.swift 顯示每個清單的項目,界面則都在 Main.storyboard 中。本教程的目標是讓這份 storyboard 更有條理,同時加入查看備註、記錄殭屍生存日誌的能力。storyboard 裡還有兩個未被使用的場景,完成教程後你可能想把它們接進來。
只要你曾用 storyboard 做大專案,或在團隊中與他人協作,就會知道它很快會變得難以維護:合併衝突、像意大利麵一樣纏繞的 Segue 箭頭、繞牆走的場景連線,足以讓人懷疑 storyboard 是否值得。
過去你可以在 App 中使用多個 storyboard,但 Interface Builder 無法在它們之間畫 Segue——想從另一個 storyboard 呈現視圖控制器,必須先實例化再在代碼裡手動 present。現在不必了。
Xcode 7 允許你在 Interface Builder 中加入故事板引用,它可以指向另一個 storyboard 的初始視圖控制器,也可以指向其中某個具體場景。這讓拆分 storyboard 變得容易,也免掉了大量樣板代碼,同時讓團隊成員能各自負責自己的 storyboard 而不互相踩腳。
注:故事板引用向後相容到 iOS 8,但在 iOS 8 上不能用於關係型 Segue,也不能指向外部 bundle 中的 storyboard。
「安然」目前還很簡單,但結構上已經到了該拆分的時候。它使用標籤欄控制器,很自然地可以按每個分頁拆成獨立 storyboard。
打開 Main.storyboard,縮放到能看見全部六個場景(可按 command + 放大、- 縮小,或右鍵點擊空白處選擇縮放級別),然後選中除標籤欄控制器之外的所有場景。

選擇 Edit\Refactor to Storyboard,命名為 Checklists,把 Group 設為 Checklists 後點擊 Save。Xcode 會自動完成三件事:把選中場景剪切到新的 storyboard;把標籤欄控制器的「視圖控制器」Segue 目標改為指向新 storyboard 的故事板引用;然後帶你進入新文件。

回到 Main.storyboard 看看發生了什麼:

標籤欄控制器的 Segue 現在指向名為 Checklists.storyboard 的故事板引用,並透過場景 ID 決定載入哪個場景。同時 Xcode 還留下了幾個「懸空」的故事板引用,已經用不上了,刪掉即可。
注:如果場景沒有設置 Storyboard ID,重構命令會自動生成類似 UIViewController-GTY-C7-… 這樣難看的 ID。與其事後修改,不如養成主動設置 Storyboard ID 的習慣。
故事板引用也可以不指向具體視圖控制器,而是直接指向該 storyboard 的初始場景。在 Main.storyboard 中選中名為 ChecklistsNavigationController 的引用,用屬性檢查器刪除其中的 ID:

打開 Checklists.storyboard,選中「Checklists Navigation Controller」場景,在屬性檢查器中勾選 Is Initial View Controller,標明它是該 storyboard 的入口。

構建並運行,App 行為與之前完全一致——只是背後的結構整齊了許多。
故事板的並行開發一直是痛點,不少開發者正因害怕合併衝突而回避它。故事板引用可以緩解這個問題。
假設你的隊友負責日記功能,已經在自己的 storyboard 中完成,現在你需要把它接進來。在項目導航器中選中頂層的 Checklists 組,選擇 File\Add Files to "Checklists",定位到 Checklists 文件夾並選中 Diary 文件夾,勾選「Copy items if needed」,Folder 選 Create groups,Target 勾選 Checklists,點擊 Add。
回到 Main.storyboard,從對象庫拖一個 Storyboard Reference 到空白處:

按住 Ctrl 從標籤欄控制器拖到這個引用,在彈出選單的 Relationship Segue 中選擇 view controller。然後選中引用,在屬性檢查器把 Storyboard 設為 Diary:


構建運行,你會看到多出一個日記分頁——隊友寫好的功能就這樣接入了。

注:此時標籤欄顯示的標題仍是 storyboard 中的 Items,真正的標題會在各自 storyboard 加載時顯示。你可以為了看著方便改一下,但這不影響運行時表現。
調試時想單獨跑某個深埋在層級深處的場景,是不是很麻煩?有了故事板引用,可以把感興趣的場景抽成獨立 storyboard,並讓 App 直接從那裡啟動。
在 Checklists.storyboard 中選中「清單詳情視圖控制器」、「添加項目導航控制器」與「添加項目視圖控制器」三個場景:

選擇 Edit\Refactor to Storyboard,命名為 ChecklistDetail.storyboard,Group 保持 Checklists。接著把其中的「清單詳情視圖控制器」勾選為初始視圖控制器,它左側會出現一個箭頭。
點擊項目導航器頂部的 Checklists 專案,選中 target 並切到 General 標籤,把 Main Interface 改為 ChecklistDetail.storyboard:

構建運行,App 會直接進入清單詳情場景:

導航欄與標籤欄都不見了——因為這個視圖控制器不再嵌入在它們裡面。注意:若初始視圖控制器依賴 Segue 傳入的數據,這種做法會失效;本專案中 ChecklistDetailViewController 已有初始示例數據,所以能正常顯示。
storyboard 中有個不太起眼的特性叫場景碼頭,位於當前所選場景的上方:

默認情況下,場景碼頭包含該視圖控制器、First Responder 以及可用的 Segue 出口。而你完全可以往裡面添加自己的視圖——Xcode 7 開始支援直接在 storyboard 中設計這些補充視圖。
注意:拖進場景碼頭的視圖不會成為視圖控制器的初始子視圖,你需要為它建立 IBOutlet,在運行時按需使用。
「安然」裡選中的表格行是一塊無聊的灰色。接下來我們不寫一行代碼,只靠場景碼頭換掉它。
在 ChecklistDetail.storyboard 中選中「清單詳情視圖控制器」,從對象庫拖一個 View 到場景碼頭:

新視圖會出現在場景碼頭上方,你可以像對待普通視圖一樣往裡加子視圖、設置約束。
選中它,在屬性檢查器把背景色改為 #FFFAE8。它在 storyboard 中的尺寸並不重要,使用前會自動撐開;若想少佔空間,可以拖動上、左、右邊緣縮小它。
在文檔大綱中按住 Ctrl,從 ChecklistItemCell 拖到這個新視圖,選擇 selectedBackgroundView:

構建運行,點擊任意一行,它就被你的新視圖高亮起來了——全程零代碼。

注:這種著色方式只適用於未開啟多選的表視圖。因為視圖只有一個實例、在所有 Cell 之間共享,同一時間只能作用於一行。
實務中經常會遇到「只在特定條件下才顯示」的視圖。把它設計進視圖層級會讓 storyboard 變得凌亂;而場景碼頭的好處正是讓你可以先在視覺上獨立地設計它,需要時再用代碼加入視圖層級。
接下來要做一个顯示備註的視圖:點擊某行時該行展開並顯示對應備註,再點一次或點其他行則折疊。
在 ChecklistDetail.storyboard 中拖一個新的 View 到場景碼頭(就在上一節的選中背景視圖旁邊),用尺寸檢查器把寬設為 320、高設為 128。往裡拖一個 Label,文本改為「注:」,顏色改為 #BB991E,必要時調整位置讓文本完整顯示:

再拖一個 TextView 進去,用屬性檢查器刪掉默認的 Lorem ipsum 文本,取消勾選 Editable 與 Selectable,然後調整層次讓它們貼合容器邊緣:

現在把它連到代碼。雖然螢幕上可能同時存在多個 Cell 實例,但備註視圖始終只有一個實例,所以連到 outlet 不會有問題。
打開 ChecklistDetail.storyboard 並進入助理編輯模式顯示 ChecklistDetailViewController.swift(必要時可關閉文檔大綱騰出空間):

按住 Ctrl 從視圖(注意是背景視圖本身,不是 textView 或 label;也可以從場景碼頭的視圖圖標拖)連到代碼,位置放在現有 clothing 屬性附近,命名為 notesView:

再從 textView 拖出第二個 outlet,命名為 notesTextView。
最後寫點代碼。這裡還會用到 iOS 9 的另一個新特性 UIStackView,用來動態添加與移除備註視圖並自帶動畫。
在主類實現底部加入:
func addNotesViewToCell(cell: ChecklistItemTableViewCell) {
notesView.heightAnchor.constraintEqualToConstant(notesViewHeight).active = true
notesView.clipsToBounds = true
cell.stackView.addArrangedSubview(notesView)
}
這個方法先用 Auto Layout 給備註視圖一個確定的高度,再把它加入 Cell 堆疊視圖的 arrangedSubviews;同時把 clipsToBounds 設為 true,避免左滑刪除時 textView 溢出 Cell。高度必須在這裡設置,因為堆疊視圖的高度由 arrangedSubviews 撐開,不設高的話 Cell 不會變高。
接著加入移除方法:
func removeNotesView() {
if let stackView = notesView.superview as? UIStackView {
stackView.removeArrangedSubview(notesView)
notesView.removeFromSuperview()
}
}
然後在視圖控制器裡使用它們。找到表視圖的 delegate 擴展,加入:
override func tableView(tableView: UITableView, didSelectRowAtIndexPath indexPath: NSIndexPath) {
// 1
guard let cell = tableView.cellForRowAtIndexPath(indexPath) as? ChecklistItemTableViewCell
else { return }
// 2
tableView.beginUpdates()
// 3
if cell.stackView.arrangedSubviews.contains(notesView) {
removeNotesView()
} else {
addNotesViewToCell(cell)
// 4
notesTextView.text = checklist.items[indexPath.row].notes
}
// 5
tableView.endUpdates()
}
這段代碼依次做了五件事:用 Swift 2.0 的 guard 確保選中的 Cell 型別正確;調用 beginUpdates() 讓高度變化帶動畫;根據堆疊視圖是否已包含備註視圖決定移除還是添加;更新 textView 文本為該條目的備註;最後用 endUpdates() 提交改動。
最後別忘了把主界面改回去:選中專案與 target,在 General 中把 Main Interface 改回 Main.storyboard。

構建運行,點擊任意 Cell 就能看到備註視圖展開。有了堆疊視圖,你不需要手動算 Frame,也不需要為 Cell 額外添加約束——只要給備註視圖一個確定高度即可。在更早的 iOS 版本上,這個效果實現起來要棘手得多。

注:場景碼頭適合承載只屬於單個視圖控制器的補充視圖。如果某個視圖會在多處重複使用,更好的做法是把它做成獨立的 XIB 文件。