導航列是 iOS 層級式內容瀏覽的骨架。以下把 UINavigationBar、UINavigationItem、UIBarItem、UIBarButtonItem 與 UITabBarItem 的職責與使用禁忌整理成一份速查筆記。
它提供了一個用於瀏覽階層式內容的控制元件。外觀可透過 barStyle、tintColor、translucent 三個屬性調整,例如把 barStyle 設為 UIBarMetricsDefault 的黑底半透明樣式。
與一般 view 不同,不要把子 view 直接 addSubview 到導航列上。正確做法是用一個 UINavigationItem 描述你想顯示的按鈕或自訂 view。navigation item 可以分別指定左側、中央、右側的 view,也能設定一段自訂的 prompt 文字。
導航列內部維護一個 UINavigationItem 的堆疊,堆疊最頂端的那個項目就是目前畫面上顯示的內容。用 pushNavigationItem:animated: 推入、用 popNavigationItemAnimated: 彈出;也可以直接用 items 屬性或 setItems:animated: 一次設定整組堆疊。
若由導航控制器管理畫面間的切換,它會自動建立導航列,並在合適的時機推入或彈出 navigation item。此時:
1. 修改 barStyle、tintColor、translucent 是安全的;但絕對不要直接改動 frame、bounds、alpha、hidden 這類 UIView 層級屬性。
2. 讓導航控制器自己管理 item 堆疊,不要手動介入。
3. 導航控制器會自動把自己設為導航列的 delegate,你不必、也不該搶走這個角色。
它封裝了「被推上導航列堆疊的項目」相關資訊:當它位於堆疊頂端時如何呈現,以及當它作為返回項時如何顯示。
用 initWithTitle: 建立並指定標題;沒有標題的 item 無法在導航列上正確呈現。若想讓返回按鈕顯示不同文字,請設定 backBarButtonItem;這個屬性會作為返回按鈕呈現,除非你另外指定了自訂的左側 view。
預設行為是左側顯示返回鍵、中央顯示標題。要改變,可用 setLeftBarButtonItem:animated: 與 setRightBarButtonItem:animated: 替換左右 view,用 titleView 屬性把中央換成自訂 view(例如放上一個搜尋框或 logo)。
這是加入底部橫列各元件的抽象父類別。列上的項目行為類似按鈕,擁有 title、image、action、target,也可以啟用或停用。
專門用來放在 UIToolbar 或 UINavigationBar 上的按鈕項目,從 UIBarItem 繼承基本的按鈕行為,另外定義了適合工具列與導航列的初始化方法與屬性,例如以固定空間(UIBarButtonSystemItemFlexibleSpace)做間隔,或用 initWithBarButtonSystemItem:target:action: 快速取得系統圖示。
代表 UITabBar 上的一個項目。Tab bar 嚴格運作在「單選」模式,一次只有一個項目被選中,點擊會切換上方顯示的 view。你可以透過 badgeValue 加上紅色角標,例如電話 App 用它顯示未讀訊息數。
用 initWithTabBarSystemItem:tag: 建立系統內建項目(如「聯絡人」「最近」等);用 initWithTitle:image:tag: 建立自訂項目。若要讓選中態呈現不同顏色,請設定 image 的 renderingMode 為 alwaysOriginal,再自行處理 selectedImageTintColor。
導航列與工具列的內容一律透過「item 物件」描述,而非直接塞 subview;與導航控制器搭配時只碰外觀屬性,其餘交給控制器;標題與返回按鈕的呈現優先用 UINavigationItem 的既有屬性解決。