cordova.InAppBrowser.open()
を使用して、InAppBrowser ウィンドウ ( InAppBrowser 提供の Web ブラウザー ) を開きます。cordova.InAppBrowser.open()
関数は、window.open()
関数を代替する関数です。window.open()
を使用して、InAppBrowser ウィンドウを開くことができます。lightcontent
、darkcontent
、または default
。デフォルトは「default」)iOS のテキストの色のスタイルを設定します。 「lightcontent」は、暗い背景での使用を目的としています。 「darkcontent」は、iOS 13 以降でのみ使用可能で、明るい背景での使用を目的としています。InAppBrowser
の新規インスタンス内、現在開いているブラウザーのインスタンス内、または、system browser ( システムブラウザー ) 内で、URL を開きます。'_blank'
に設定されているときのInAppBrowser
ウィンドウへのリファレンス。 (InAppBrowser)encodeURI()
を使用して変換します。 (String)_self
となります。 (String)_self
: ホワイトリストに対象の URL が登録されている場合には、Cordova WebView を開きます。それ以外の場合には、InAppBrowser
を開きます。_blank
: InAppBrowser
を開きます。_system
: システム標準の Web ブラウザー ( system's web browser ) を開きます。InAppBrowser
で使用する、任意のオプションです。デフォルトは、location=yes
となります。 (String) options
で使用する文字列に、空白は使用できません。また、各設定 ( 名前と値の組み合わせ ) の間を、コンマで区切る必要があります。各設定の名前では、大文字・小文字を区別しません。yes
または no
を設定すると、InAppBrowser
のロケーションバーを、それぞれ、表示または非表示にできます。yes
に設定した場合、ブラウザーの 「 作成 」 とページの読み込みを行いますが、表示はしません。読み込みが完了すると、loadstop イベントが発火します。省略または no
( デフォルト ) に設定した場合、通常通り、ブラウザーを開き、読み込みを行います。yes
です。POST リクエストは、現在サポートされておらず、無視されることに注意してください(beforeload=post
を設定すると、エラーが発生します )。yes
に設定した場合、新規のウィンドウを開く前に、ブラウザーの cookie とキャッシュを削除します。yes
に設定した場合、新規のウィンドウを開く前に、セッションの cookie とキャッシュを削除します。yes
に設定している場合にのみ有効です。yes
に設定した場合、フッターに閉じるボタンが iOS の完了ボタンと同様に表示されます。 閉じるボタンはヘッダーと同じように表示されるため、closebuttoncaption と closebuttoncolor を使用してプロパティを設定します。yes
に設定している場合にのみ効果があります。yes
に設定した場合、ハードウェア標準の 「 戻る 」 ボタンを使用して、前のページに戻ります ( InAppBrowser に記録されているページ遷移の履歴を使用 )。「 前のページ 」 が存在しない場合には、InAppBrowser が閉じます。デフォルト値は yes
です。「 戻る 」 ボタンを使用して、InAppBrowser を閉じたい場合には、no
に設定します。yes
に設定した場合、ロケーションツールバーのナビゲーションボタンが非表示になります。ユーザーがロケーションを yes
に設定している場合にのみ有効です。 デフォルト値は no
です。yes
に設定した場合、ロケーションツールバーの URL バーが非表示になります。ユーザーが location を yes
に設定した場合にのみ有効です。 デフォルト値は no
です。yes
に設定し、hidenavigationbuttons を yes
に設定していない場合にのみ効果があります。yes
に設定した場合、ナビゲーションボタンと閉じるボタンの位置が入れ替わります。 具体的には、ナビゲーションボタンは左に、閉じるボタンは右に移動します。yes
に設定した場合、Android ブラウザーのズームコントロール ( 制御バー ) が表示されます。no
に設定した場合、非表示になります。デフォルト値は yes
です。yes
または no
に設定して、 HTML5 の audio または video の自動再生を、有効または無効にします ( デフォルトは no
)。yes
に設定します。( これは、CB-11013 のような Google Play の問題を避けるために必要な場合があります。)viewport
タグのサポートを有効にするか、wide viewport
を使用するかを設定します。設定の値が no
の場合、レイアウト幅は常に端末非依存(CSS)ピクセルの WebView コントロールの幅に設定されます。値が yes
で、ページに viewport タグが含まれている場合、タグで指定された幅の値が使用されます。ページにタグが含まれていないか、幅が指定されていない場合は、wide viewport が使用されます。( デフォルトは yes
です )。yes
です。yes
に設定した場合、ブラウザーの 「 作成 」 とページの読み込みを行いますが、表示はしません。読み込みが完了すると、loadstop イベントが発火します。省略または no
( デフォルト ) に設定した場合、通常通り、ブラウザーを開き、読み込みを行います。yes
です。POST リクエストは、現在サポートされておらず、無視されることに注意してください( beforeload=post
を設定すると、エラーが発生します )。yes
に設定した場合、新規のウィンドウを開く前に、ブラウザーの cookie とキャッシュを削除します。yes
に設定した場合、新規のウィンドウを開く前に、セッションの cookie とキャッシュを削除します。yes
に設定した場合、新しいウィンドウが開く前にブラウザのローカルストレージ全体( Cookie、HTML5 ローカルストレージ、IndexedDB など )がクリアされます。yes
または no
に設定すると ( デフォルトで no
)、UIWebViewBounce プロパティを、それぞれ、オンまたはオフにします。yes
または no
に設定して、ツールバーのナビゲーションボタンをオンまたはオフにします( デフォルトは no
)。 ツールバーが無効になっていない場合にのみ適用されます。yes
または no
に設定した場合、InAppBrowser
のツールバーを、それぞれ、表示または非表示にします ( デフォルトは yes
)。yes
または no
に設定した場合、ツールバーが半透明( 半透明 )になります( デフォルトは yes
)。 ツールバーが無効になっていない場合にのみ適用されます。yes
に設定した場合、ナビゲーションボタンと閉じるボタンの位置が入れ替わります。 具体的には、閉じるボタンは右側に、ナビゲーションボタンは左側に移動します。yes
) または無効 ( no
) にします ( デフォルトは no
)。yes
または no
に設定して、 HTML5 の audio または video の自動再生を、有効または無効にします ( デフォルトは no
)。yes
または no
に設定して、端末標準のメディア再生用インターフェイスではなく、ブラウザーウィンドウ内でのインライン再生を許可するか設定します。HTML の video
要素には webkit-playsinline
属性を指定する必要があります ( デフォルトは no
)。pagesheet
、formsheet
、fullscreen
のいずれかを設定します ( デフォルトは fullscreen
)。fliphorizontal
、crossdissolve
、coververtical
のいずれかを設定します ( デフォルトは coververtical
)。top
または bottom
に設定して、ツールバーの表示位置 ( ウィンドウの上・下 ) を指定します ( デフォルトは bottom
)。yes
または no
に設定します( デフォルトは no
)。'_blank'
に設定されているときに cordova.InAppBrowser.open
の呼び出しから返されたオブジェクトです。InAppBrowser
からイベントリスナーを登録します。 ( ターゲットが '_blank'
に設定されている場合のみ使用可能 )InAppBrowser
ウィンドウへのリファレンス (InAppBrowser)InAppBrowser
が URLの読み込みを始めたときに発火するイベントInAppBrowser
が URLの読み込みを終えたときに発火するイベントInAppBrowser
がエラーを検出したときに発火するイベントInAppBrowser
ウィンドウを閉じるときに発火するイベントInAppBrowserEvent
loadstart
、loadstop
、loaderror
、message
、exit
のいずれかとなります。 (String)loaderror
が発生した場合のみ ) (Number)loaderror
が発生した場合のみ )(String)InAppBrowser
からイベントリスナーを削除します。 ( ターゲットが '_blank'
に設定されている場合のみ使用可能 )InAppBrowser
ウィンドウへのリファレンス (InAppBrowser)InAppBrowser
が URLの読み込みを始めたときに発火するイベントInAppBrowser
が URLの読み込みを終えたときに発火するイベントInAppBrowser
がエラーを検出したときに発火するイベントInAppBrowser
ウィンドウを閉じるときに発火するイベントInAppBrowserEvent
InAppBrowser
ウィンドウを閉じます。InAppBrowser
ウィンドウへのリファレンス (InAppBrowser)InAppBrowser
ウィンドウ上に、JacaScript コードをインジェクト ( inject/注入 ) します。(ターゲットが '_blank'
に設定されている場合のみ使用可能)InAppBrowser
ウィンドウへのリファレンス (InAppBrowser)file
または code
キーを指定します。 (Object)code
の場合、callbackに、配列
形式のパラメーターが 1つ渡され実行されます。このパラメーターは、インジェクトしたスクリプトの実行結果( 戻り値 )です。複数行のスクリプトに関しては、最後のステートメント (statement ) の戻り値、または、最後に評価 ( evaluate ) した表現 (expression ) が、引き渡すパラメーターとなります。InAppBrowser
ウィンドウに挿入します。(ターゲットが '_blank'
に設定されている場合のみ使用可能)InAppBrowser
ウィンドウへのリファレンス (InAppBrowser)file
または code
キーを指定します。 (Object)onDeviceReady
関数でユーザーの選択肢を収集し、適切な URL を共有ライブラリファイルのヘルパー関数に送信します。 ヘルパー関数は showHelp() です。次にその関数を記述します。open
関数を使用してヘルプページを読み込みます。hidden プロパティを yes に設定しているため、ページコンテンツが読み込まれた後にのみブラウザを表示できます。 こうすることで、ユーザーはコンテンツが表示されるのを待つ間に空白のブラウザが表示されなくなります。 loadstop イベントが発生すると、コンテンツがいつロードされたかがわかります。 loadstop イベントを処理します。loadstopcallback
イベントが発生すると、コンテンツがロードされたことがわかり、ブラウザを表示させることができます。 このような仕掛けは、より良いパフォーマンスの印象を作り出すことができます。 実は、コンテンツが読み込まれる前にブラウザを表示するかどうかにかかわらず、読み込み時間は同じです。insertCSS
関数の呼び出しに気づいたかもしれません。これは、今回のサンプルの主な目的ではありませんが、この場合、ページのフォントサイズが一定のサイズになっていることを確認しています。この関数を使用して、任意の CSS スタイル要素を挿入できます。 プロジェクト内の CSS ファイルを指すこともできます。alert
関数を呼び出すスクリプトを注入することで、これを行うことができます。これは Windows デバイス上のブラウザでは機能しないため、executeScript コールバック関数のパラメータを調べて、有効かどうかを確認する必要があります。動作しない場合は、ページの <div>
にエラーメッセージが表示されます。