最終更新
役に立ちましたか?
最終更新
役に立ちましたか?
StatusBar
オブジェクトを使用して、iOS と Android のステータスバーをカスタマイズできます
このプラグインの詳細は、 をご確認ください。
このプラグインを使用する場合には、Monaca クラウド IDE の [ Cordova プラグインの管理 ] 上で、StatusBar
プラグインをにします。
StatusBarOverlaysWebView ( デフォルトでは true ) アプリの起動時、WebView 上にステータスバーを置くか ( overlay/オーバーレイ ) 否かを設定します。
StatusBarBackgroundColor ( 16 進数の文字列で示すカラーコード、デフォルトはなし )
アプリ起動時のスタータスバーの背景色を、16進数の文字列 ( #RRGGBB ) で設定します。この値が設定されていない場合、背景色は透明になります。StatusBarOverlaysWebViewが
trueに設定されている場合、オプションで8桁の16進数(#AARRGGBB)文字列を使用して、透明度を定義することができる。
StatusBarStyle ( ステータスバーのスタイル、デフォルトは lightcontent ) ステータスバーのスタイル ( 色 ) を設定します。 default、lightcontent、blacktranslucent、blackopaque のいずれかを設定できます。iOS 7 が対象です。
StatusBarDefaultScrollToTop ( ブール値、デフォルトは false ) iOSの場合、Cordova WebViewがデフォルトのスクロールトゥトップ動作を使用することを許可します。デフォルトは false で、代わりに "statusTap" イベント (後述) をリッスンして動作をカスタマイズすることができます。
Android 5+のガイドラインでは、ステータスバーにメインアプリの色とは異なる色を使用することが指定されています(多くのiOSアプリのステータスバーの色が統一されているのとは異なります)ので、ステータスバーの色をStatusBar.backgroundColorByHexString
またはStatusBar.backgroundColorByNameで
実行時に設定することが望ましいかもしれません。そのための一つの方法として、次のようなものがあります:
iOS 11以降、ステータスバーをウェブビューにオーバーレイさせたい場合は、viewport metaタグにviewport-fit=coverを
含める必要があります
このプラグインは、グローバルな StatusBar
オブジェクトを定義します。 グローバルスコープでは、deviceready
イベントの発火後まで使用できません。
StatusBar.overlaysWebView
StatusBar.styleDefault
StatusBar.styleLightContent
StatusBar.backgroundColorByName
StatusBar.backgroundColorByHexString
StatusBar.hide
StatusBar.show
iOS 7 のステータスバーを上書きします ( WebView の上書きではありません )。
iOS 7 のステータスバーを、iOS 6 のように表示したい場合、false に設定します。
デフォルトのステータスバーを使用します ( 黒の文字、白の背景 )。
lightContent のステータスバーを使用します ( 白の文字、黒の背景 )。
StatusBar.overlaysWebView を false にした場合 ( iOS 7 上で iOS 6 のようなステータスバーを使用 )、色の名前を指定して、ステータスバーの背景色を設定できます。
サポート対象の色の名前は、次のとおりです。
16 進数の文字列を使用して、ステータスバーの背景色を設定します。
CSS のショートハンド プロパティ ( 簡略化表記 ) も使用できます。
StatusBar.overlaysWebView を false にした場合 ( iOS 7 上で iOS 6 のようなステータスバーを使用 )、16 進数の文字列 ( #RRGGBB ) を使用して、ステータスバーの背景色を設定できます。
ステータスバーを非表示にします。
ステータスバーを表示します。
ステータスバーの状態 ( 表示または非表示 ) を確認する場合には、このプロパティを使用します。
このイベントを監視して、ステータスバーがタップされたかどうかを確認します。iOSのみ対応。