要讓 iOS 狀態列(時間、電量、訊號那一列)的文字變成白色,需要兩個步驟。
在 Info.plist 中新增一筆:
Key: View controller-based status bar appearance Type: Boolean Value: NO
這個設定預設是 YES,代表「由每個 view controller 自行決定狀態列樣式」。設為 NO 之後,改由 App 全域層級統一控制,這時 UIApplication 的 setter 才會生效。
[[UIApplication sharedApplication] setStatusBarStyle:UIStatusBarStyleLightContent animated:NO];
UIStatusBarStyleLightContent 就是「白色文字」;對應的 UIStatusBarStyleDefault 是深色文字(黑字)。注意這裡的 Light 指的是內容(content)為淺色,也就是文字是白的,通常搭配深色背景使用。
全域控制(上面這種)適合整個 App 都是同一種狀態列風格的情況,例如全 App 深色主題。設定一次即可,程式碼最簡單。
逐頁控制(Info.plist 保持 YES)則在每個 view controller 中實作:
- (UIStatusBarStyle)preferredStatusBarStyle {
return UIStatusBarStyleLightContent;
}
// 若需在執行期動態改變
- (void)viewWillAppear:(BOOL)animated {
[super viewWillAppear:animated];
[self setNeedsStatusBarAppearanceUpdate];
}
這個方式的優點是不同頁面可以有不同狀態列樣式,例如在相簿預覽這種全黑背景下用白字,回到列表時切回黑字。
設了沒反應。九成是 Info.plist 那個開關沒設成 NO。當 View controller-based status bar appearance 為 YES 時,setStatusBarStyle: 的呼叫會被系統忽略。
在子 view controller 中沒效果。逐頁控制時,系統只會詢問最上層被呈現的 view controller。若你的頁面是包在 navigation controller 裡,要嘛在 nav controller 子類別中實作 preferredStatusBarStyle 並轉發給 topViewController,要嘛用 childViewControllerForStatusBarStyle 指定由誰決定。
UIStatusBarStyleLightContent 在 iOS 7 之前叫 UIStatusBarStyleLightContent 以外的名稱。舊的 UIStatusBarStyleBlackOpaque 與 UIStatusBarStyleBlackTranslucent 已廢棄,新專案一律用 LightContent 與 Default。
别忘了對比度。狀態列文字顏色是-white 還是-dark,取決於狀態列背後的內容,而不是整個頁面的主題色。若頁面頂端是白色 header 但整頁是深色,狀態列仍應使用深色文字。