# org.apache.cordova.statusbar # StatusBar > `StatusBar`物件提供了一些功能，自訂的 iOS 和 Android 狀態列。 ## 首選項 #### config.xml * **StatusBarOverlaysWebView**（布林值，預設值為 true）。在 iOS 7，使狀態列覆蓋或不覆蓋 web 視圖在啟動時。 * **StatusBarBackgroundColor**（顏色十六進位字串，預設值為 #000000）。在 iOS 7，通過一個十六進位字串 （#RRGGBB） 在啟動時設置狀態列的背景色。 * **狀態列**（狀態列樣式，預設值為 lightcontent）。在 iOS 7，設置的狀態橫條圖樣式。可用的選項預設，lightcontent，blacktranslucent，blackopaque。 ## 在啟動時隱藏 在運行時期間，你可以使用 StatusBar.hide 函數下面，但如果你想要顯示狀態列隱藏在應用程式啟動時，你必須修改你的應用程式的 Info.plist 檔。 添加編輯這兩個屬性，如果不存在。 將**"狀態列最初隱藏"**設置為**"YES"**和**"視圖基於控制器的狀態列外觀"**設置為**"否"**。 如果您手動編輯它沒有 Xcode，鍵和值是： UIStatusBarHidden UIViewControllerBasedStatusBarAppearance ## 方法 * StatusBar.overlaysWebView * StatusBar.styleDefault * StatusBar.styleLightContent * StatusBar.styleBlackTranslucent * StatusBar.styleBlackOpaque * StatusBar.backgroundColorByName * StatusBar.backgroundColorByHexString * StatusBar.hide * StatusBar.show ## 屬性 * StatusBar.isVisible ## 許可權 #### config.xml # StatusBar.overlaysWebView 在 iOS 7，使狀態列覆蓋或不覆蓋 web 視圖。 StatusBar.overlaysWebView(true); ## 描述 在 iOS 7，設置為 false，使狀態列出現像 iOS 6。設置的樣式和背景的顏色，以適應使用其他函數。 ## 支援的平臺 * iOS ## 快速的示例 StatusBar.overlaysWebView(true); StatusBar.overlaysWebView(false); # StatusBar.styleDefault 使用預設狀態列 （淺色背景深色文本）。 StatusBar.styleDefault() ； ## 支援的平臺 * iOS * Windows Phone 7 * Windows Phone 8 # StatusBar.styleLightContent 使用 lightContent 狀態列 （光文本，為深色的背景）。 StatusBar.styleLightContent(); ## 支援的平臺 * iOS * Windows Phone 7 * Windows Phone 8 # StatusBar.styleBlackTranslucent 使用 blackTranslucent 狀態列 （光文本，為深色的背景）。 StatusBar.styleBlackTranslucent(); ## 支援的平臺 * iOS * Windows Phone 7 * Windows Phone 8 # StatusBar.styleBlackOpaque 使用 blackOpaque 狀態列 （光文本，為深色的背景）。 StatusBar.styleBlackOpaque(); ## 支援的平臺 * iOS * Windows Phone 7 * Windows Phone 8 # StatusBar.backgroundColorByName 在 iOS 7，當你將 StatusBar.statusBarOverlaysWebView 設置為 false，你可以設置狀態列的背景顏色由顏色名稱。 StatusBar.backgroundColorByName("red"); 支援的顏色名稱是： black, darkGray, lightGray, white, gray, red, green, blue, cyan, yellow, magenta, orange, purple, brown ## 支援的平臺 * iOS * Windows Phone 7 * Windows Phone 8 # StatusBar.backgroundColorByHexString 由十六進位字串設置狀態列的背景色。 StatusBar.backgroundColorByHexString("#C0C0C0"); 此外支援 CSS 速記屬性。 StatusBar.backgroundColorByHexString("#333"); // => #333333 StatusBar.backgroundColorByHexString("#FAB"); // => #FFAABB 在 iOS 7，當你將 StatusBar.statusBarOverlaysWebView 設置為 false，你可以設置狀態列的背景顏色由十六進位字串 （#RRGGBB）。 WP7 和 WP8 您還可以指定值為 #AARRGGBB，其中 AA 是 Alpha 值 ## 支援的平臺 * iOS * Windows Phone 7 * Windows Phone 8 # StatusBar.hide 隱藏狀態列。 StatusBar.hide(); ## 支援的平臺 * iOS * 安卓系統 * Windows Phone 7 * Windows Phone 8 # StatusBar.show 顯示狀態列。 StatusBar.show(); ## 支援的平臺 * iOS * 安卓系統 * Windows Phone 7 * Windows Phone 8 # StatusBar.isVisible 讀取此屬性，以看看是否狀態列是可見的或不。 if (StatusBar.isVisible) { // do something } ## 支援的平臺 * iOS * 安卓系統 * Windows Phone 7 * Windows Phone 8