本文由 CocoaChina 譯者 candeladiao 翻譯,原文為 iOS 9: Getting Started with UIStackView。
和以往每個版本一樣,iOS 9 帶來了一批新特性,而 UIKit 其中最受矚目的莫過於 UIStackView——它將從根本上改變我們在 iOS 上排版使用者介面的方式。本文帶你動手做一個小範例,實際感受它的威力。
本文假設你已熟悉 Auto Layout 基礎。若還不熟悉,建議先補上相關教程;要理解 Stack View 為何好用、以及它底層做了什麼,對 Auto Layout 的理解是前提。
我們要做一個 App 評分提示:使用者可以點擊增加星星或移除星星來打分。完成後大致如下:
先從 GitHub 下載範例專案並打開,Main.storyboard 裡已經放好了兩個 Stack View:
接下來就是用這兩個 Stack View 完成整個版面。開始之前,先搞懂它是怎麼運作的。
Stack View 的核心功能就是輕鬆地水平或垂直排列多個 subview。如果你寫過 Android,它與 LinearLayout 的概念非常接近。
它最有價值的地方在於:會自動為每個 subview 建立並加上 Auto Layout 約束。你依然能控制 subview 的大小與位置,只是改成透過選項來配置排列方式與間距,而不必手寫一長串 constraint。
在 storyboard 中選取 Stack View,打開 Attributes Inspector:
把術語簡化來記:Alignment 管 X 與 Y 值,Distribution 管寬與高。兩者都會影響對齊。若勾選 Baseline Relative,會依 subview 的基線調整垂直間距;若勾選 Layout Margins Relative,則相對於標準邊界空白來定位 subview。
還有一點必須記住:Stack View 會被視為一個 Container View,它是 UIView 的子類,但不會被渲染。因此設定它的 backgroundColor 或改寫 drawRect: 都不會有任何效果——它只是個看不見的排版容器。
開始使用前,先釐清這兩個屬性的差別。要讓 Stack View 管理某個 subview,應該呼叫 addArrangedSubview: 或 insertArrangedSubview:atIndex:。arrangedSubviews 是 subviews 的子集。
要解除管理,需要同時呼叫 removeArrangedSubview: 與 removeFromSuperview。這個設計很重要:從 arrangedSubviews 移除,只是讓 Stack View 不再管理它的約束,並不會把它從視圖階層中刪除。
選取上方那個 Stack View,在 Attributes Inspector 中做三項調整:
這等於告訴 Stack View:為 subview 加上約束使其水平居中、沿軸線對稱分佈,彼此間距 30。若 subview 尺寸與 Stack View 的內容區不符,系統會依 compression resistance 優先級拉伸或壓縮它們;若版面存在歧義,Stack View 會依 subview 在 arrangedSubviews 中的索引逐一回退調整,直到剛好適應為止。
往上方的 Stack View 裡依序拖入一個 label、一個 image view 和一個 button,然後修改屬性:label 文字設為「How do you like our app?」並置中;image view 的 Image 設為 logo、Content Mode 設為 Aspect Fit;button 文字設為「Add Star!」。
執行 App。你只做了幾下滑鼠,就得到了三個能自動響應方向與 size class 變化的 subview——而且一行約束都沒寫。
執行時點擊 Xcode 底部的 Debug View Hierarchy 按鈕,可以即時檢視視圖階層:
選取剛才加入的任一 subview,打開 Size Inspector,你會看到 Stack View 已經默默替它加好了約束。下圖是 button 的約束:
停止執行,回到 storyboard,為按鈕建立名為 addStar 的 IBAction,關聯到 Touch Up Inside:
@IBAction func addStar(sender: AnyObject) {
let starImgVw: UIImageView = UIImageView(image: UIImage(named: "star"))
self.horizontalStackView.addArrangedSubview(starImgVw)
UIView.animateWithDuration(0.25, animations: {
self.horizontalStackView.layoutIfNeeded()
})
}
這裡有個重點:因為 Stack View 自動管理約束,動畫只能靠呼叫 layoutIfNeeded 來觸發,而不能像以前那樣手動改 constant。
編譯執行,點幾下 add star,結果卻不太理想:
選取下方的 Stack View 看 Attributes Inspector 就明白了:Alignment 與 Distribution 都是 Fill,於是星星被拉伸填滿了整個寬度。星星越多,問題越嚴重。我們要的是星星居中顯示,而不是被拉變形。
把 Alignment 改為 Center、Distribution 改為 Fill Equally,並在方法裡補上 contentMode:
@IBAction func addStar(sender: AnyObject) {
let starImgVw: UIImageView = UIImageView(image: UIImage(named: "star"))
starImgVw.contentMode = .ScaleAspectFit
self.horizontalStackView.addArrangedSubview(starImgVw)
UIView.animateWithDuration(0.25, animations: {
self.horizontalStackView.layoutIfNeeded()
})
}
再執行一次,多按幾下,所有星星都乖乖居中了:
不能刪星星的評分功能沒什麼意義。回到 storyboard,在上方的 Stack View 裡再放一個水平的 Stack View,位置在 logo 之下、按鈕之上:
把「Add Star!」按鈕拖進這個新 Stack View,再從元件庫拖入另一個按鈕,標題改為「Remove Star」、文字顏色設為紅色:
調整新 Stack View 的屬性:
這就是 Stack View 的另一個優勢:它可以任意巢狀,而外層 Stack View 完全不需要知道內層怎麼排。
為「Remove Star」建立名為 removeStar 的 IBAction:
@IBAction func removeStar(sender: AnyObject) {
let star: UIView? = self.horizontalStackView.arrangedSubviews.last
if let aStar = star {
self.horizontalStackView.removeArrangedSubview(aStar)
aStar.removeFromSuperview()
UIView.animateWithDuration(0.25, animations: {
self.horizontalStackView.layoutIfNeeded()
})
}
}
執行 App,現在增刪都正常了。試著旋轉裝置或改變模擬器方向,看看版面如何自動調整——我們依然沒寫過一行約束。
再強調一次順序問題:removeFromSuperview 才是把 subview 從視圖階層中真正移除;removeArrangedSubview 只是告訴 Stack View 不必再管理它的約束。若只呼叫前者而沒呼叫後者,Stack View 仍會持續為一個已經不在畫面上的 view 維護約束,這是常見的思維陷阱。
UIStackView 大幅簡化了使用者介面的開發流程。在裝置尺寸越來越分歧的時代,這是件好事:它把「為簡單場景手寫一堆枯燥約束」的繁瑣工作交還給 UIKit,讓開發者能專注在真正重要的互動與資料邏輯上。
若想動手嘗試,可以從 GitHub 下載完整範例專案。