5.5 KiB
org.apache.cordova.statusbar
StatusBar
StatusBar物件提供了一些功能，自訂的 iOS 和 Android 狀態列。
首選項
config.xml
-
StatusBarOverlaysWebView（布林值，預設值為 true）。在 iOS 7，使狀態列覆蓋或不覆蓋 web 視圖在啟動時。
<preference name="StatusBarOverlaysWebView" value="true" /> -
StatusBarBackgroundColor（顏色十六進位字串，預設值為 #000000）。在 iOS 7，通過一個十六進位字串 （#RRGGBB） 在啟動時設置狀態列的背景色。
<preference name="StatusBarBackgroundColor" value="#000000" /> -
狀態列（狀態列樣式，預設值為 lightcontent）。在 iOS 7，設置的狀態橫條圖樣式。可用的選項預設，lightcontent，blacktranslucent，blackopaque。
<preference name="StatusBarStyle" value="lightcontent" />
在啟動時隱藏
在運行時期間，你可以使用 StatusBar.hide 函數下面，但如果你想要顯示狀態列隱藏在應用程式啟動時，你必須修改你的應用程式的 Info.plist 檔。
添加編輯這兩個屬性，如果不存在。 將**"狀態列最初隱藏"設置為"YES"和"視圖基於控制器的狀態列外觀"設置為"否"**。 如果您手動編輯它沒有 Xcode，鍵和值是：
<key>UIStatusBarHidden</key>
<true/>
<key>UIViewControllerBasedStatusBarAppearance</key>
<false/>
方法
- StatusBar.overlaysWebView
- StatusBar.styleDefault
- StatusBar.styleLightContent
- StatusBar.styleBlackTranslucent
- StatusBar.styleBlackOpaque
- StatusBar.backgroundColorByName
- StatusBar.backgroundColorByHexString
- StatusBar.hide
- StatusBar.show
屬性
- StatusBar.isVisible
許可權
config.xml
<feature name="StatusBar">
<param name="ios-package" value="CDVStatusBar" onload="true" />
</feature>
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