14 KiB
org.apache.cordova.inappbrowser
このプラグインを呼び出すときに表示される web ブラウザーのビューを提供します window.open() 、または時として形成されたリンクを開く<a target="_blank">.
var ref = window.open('http://apache.org', '_blank', 'location=yes');
注: ウィンドウの動作、InAppBrowser 標準的な web ブラウザーのようとコルドバの Api にアクセスできません。
インストール
cordova plugin add org.apache.cordova.inappbrowser
Firefox の OS
マニフェストのドキュメントで説明されているように、 www/manifest.webappを作成します。関連する権限を追加します。
"permissions": {
"browser": {}
}
window.open
新しい URL を開き InAppBrowser インスタンス、現在のブラウザー インスタンスまたはシステムのブラウザー。
var ref = window.open url、ターゲット (オプション);
-
ref: への参照を
InAppBrowserウィンドウ。(InAppBrowser) -
url: *(文字列)*をロードする URL。電話
encodeURI()場合は、この上の URL は Unicode 文字を含みます。 -
ターゲット: ターゲット URL は、既定値は、省略可能なパラメーターをロードするを
_self。(文字列)_self: コルドバ WebView URL がホワイト リストにある場合で開きます、それ以外の場合で開きます、InAppBrowser._blank: で開きます、InAppBrowser._system: システムの web ブラウザーで開きます。
-
オプション: おぷしょん、
InAppBrowser。省略可能にする:location=yes。(文字列)options文字列にはする必要があります任意の空白スペースが含まれていないと、各機能の名前と値のペアをコンマで区切る必要があります。 機能名では大文字小文字を区別します。 以下の値をサポートするプラットフォーム。- 場所: に設定
yesまたはnoを有効にする、InAppBrowserの場所バー オンまたはオフにします。
アンドロイドのみ:
- closebuttoncaption: [完了] ボタンのキャプションとして使用する文字列に設定します。
- 非表示: 設定
yesブラウザーを作成して、ページの読み込みが表示されません。 Loadstop イベントは、読み込みが完了すると発生します。 省略するか設定no(既定値) を開くし、通常負荷ブラウザーを持っています。 - clearcache: に設定されている
yes、ブラウザーのクッキー キャッシュ クリア新しいウィンドウが開く前に - clearsessioncache: に設定されている
yesはセッション cookie のキャッシュをオフに新しいウィンドウを開く前に
iOS のみ:
- closebuttoncaption: [完了] ボタンのキャプションとして使用する文字列に設定します。自分でこの値をローカライズする必要があることに注意してください。
- disallowoverscroll: に設定されている
yesまたはno(既定値はno)。/UIWebViewBounce プロパティをオフにします。 - 非表示: 設定
yesブラウザーを作成して、ページの読み込みが表示されません。 Loadstop イベントは、読み込みが完了すると発生します。 省略するか設定no(既定値) を開くし、通常読み込みブラウザーを持っています。 - clearcache: に設定されている
yes、ブラウザーのクッキー キャッシュ クリア新しいウィンドウが開く前に - clearsessioncache: に設定されている
yesはセッション cookie のキャッシュをオフにすると、新しいウィンドウが開く前に - ツールバー: に設定されている
yesまたはnoInAppBrowser (デフォルトのツールバーのオンまたはオフを有効にするにはyes) - enableViewportScale: に設定されている
yesまたはnoを (デフォルトではメタタグを介してスケーリング ビューポートを防ぐためにno). - mediaPlaybackRequiresUserAction: に設定されている
yesまたはnoを HTML5 オーディオまたはビデオを自動再生 (初期設定から防ぐためにno). - allowInlineMediaPlayback: に設定されている
yesまたはnoラインで HTML5 メディア再生には、デバイス固有再生インターフェイスではなく、ブラウザー ウィンドウ内に表示するようにします。 HTML のvideo要素を含める必要がありますまた、webkit-playsinline属性 (デフォルトはno) - keyboardDisplayRequiresUserAction: に設定されている
yesまたはnoをフォーム要素の JavaScript を介してフォーカスを受け取るときに、キーボードを開くfocus()コール (デフォルトはyes). - suppressesIncrementalRendering: に設定されている
yesまたはno(デフォルトでは表示される前にビューのすべての新しいコンテンツを受信するまで待機するにはno). - presentationstyle: に設定されている
pagesheet、formsheetまたはfullscreen(デフォルトでは、プレゼンテーション スタイルを設定するにはfullscreen). - transitionstyle: に設定されている
fliphorizontal、crossdissolveまたはcoververtical(デフォルトでは、トランジションのスタイルを設定するにはcoververtical). - toolbarposition: に設定されている
topまたはbottom(既定値はbottom)。上部またはウィンドウの下部にツールバーが発生します。
- 場所: に設定
サポートされているプラットフォーム
- アマゾン火 OS
- アンドロイド
- ブラックベリー 10
- iOS
- Windows Phone 7 と 8
例
var ref = window.open('http://apache.org', '_blank', 'location=yes');
var ref2 = window.open(encodeURI('http://ja.m.wikipedia.org/wiki/ハングル'), '_blank', 'location=yes');
InAppBrowser
呼び出しから返されるオブジェクトwindow.open.
メソッド
- addEventListener
- removeEventListener
- close
- show
- executeScript
- insertCSS
addEventListener
イベントのリスナーを追加します、
InAppBrowser.
ref.addEventListener(eventname, callback);
-
ref: への参照を
InAppBrowserウィンドウ*(InAppBrowser)* -
eventname: *(文字列)*をリッスンするイベント
- ****: イベントが発生するとき、
InAppBrowserの URL の読み込みが開始します。 - loadstop: イベントが発生するとき、
InAppBrowserURL の読み込みが完了します。 - loaderror: イベントが発生するとき、
InAppBrowserURL の読み込みでエラーが発生します。 - 終了: イベントが発生するとき、
InAppBrowserウィンドウが閉じられます。
- ****: イベントが発生するとき、
-
コールバック: イベントが発生したときに実行される関数。関数に渡されますが、
InAppBrowserEventオブジェクトをパラメーターとして。
InAppBrowserEvent プロパティ
-
タイプ: eventname どちらか
loadstart、loadstop、loaderror、またはexit。(文字列) -
url: URL が読み込まれました。(文字列)
-
コード: の場合にのみ、エラー コード
loaderror。(数) -
メッセージ: の場合にのみ、エラー メッセージ
loaderror。(文字列)
サポートされているプラットフォーム
- アマゾン火 OS
- アンドロイド
- iOS
- Windows Phone 7 と 8
簡単な例
var ref = window.open('http://apache.org', '_blank', 'location=yes');
ref.addEventListener('loadstart', function(event) { alert(event.url); });
removeEventListener
イベントのリスナーを削除します、
InAppBrowser.
ref.removeEventListener(eventname, callback);
-
ref: への参照を
InAppBrowserウィンドウ。(InAppBrowser) -
eventname: イベントのリッスンを停止します。(文字列)
- ****: イベントが発生するとき、
InAppBrowserの URL の読み込みが開始します。 - loadstop: イベントが発生するとき、
InAppBrowserURL の読み込みが完了します。 - loaderror: イベントが発生するとき、
InAppBrowserURL の読み込みエラーが発生します。 - 終了: イベントが発生するとき、
InAppBrowserウィンドウが閉じられます。
- ****: イベントが発生するとき、
-
コールバック: イベントが発生するときに実行する関数。関数に渡されますが、
InAppBrowserEventオブジェクト。
サポートされているプラットフォーム
- アマゾン火 OS
- アンドロイド
- iOS
- Windows Phone 7 と 8
簡単な例
var ref = window.open('http://apache.org', '_blank', 'location=yes');
var myCallback = function(event) { alert(event.url); }
ref.addEventListener('loadstart', myCallback);
ref.removeEventListener('loadstart', myCallback);
close
閉じる、
InAppBrowserウィンドウ。
ref.close();
- ref: への参照を
InAppBrowserウィンドウ*(InAppBrowser)*
サポートされているプラットフォーム
- アマゾン火 OS
- アンドロイド
- iOS
- Windows Phone 7 と 8
簡単な例
var ref = window.open('http://apache.org', '_blank', 'location=yes');
ref.close();
show
隠された開かれた InAppBrowser ウィンドウが表示されます。この関数を呼び出すは影響しません、InAppBrowser が既に表示されている場合。
ref.show();
- ref: InAppBrowser ウィンドウ (への参照
InAppBrowser)
サポートされているプラットフォーム
- アマゾン火 OS
- アンドロイド
- iOS
簡単な例
var ref = window.open('http://apache.org', '_blank', 'hidden=yes');
// some time later...
ref.show();
executeScript
JavaScript コードに挿入します、
InAppBrowserウィンドウ
ref.executeScript(details, callback);
-
ref: への参照を
InAppBrowserウィンドウ。(InAppBrowser) -
injectDetails: 詳細を実行するスクリプトのいずれかを指定する、
fileまたはcodeキー。(オブジェクト)- ファイル: スクリプトの URL を注入します。
- コード: スクリプトのテキストを挿入します。
-
コールバック: JavaScript コードを注入した後に実行される関数。
- 挿入されたスクリプトが型の場合
code、スクリプトの戻り値は、1 つのパラメーターでコールバックを実行するのに包まれて、Array。 マルチライン スクリプトについては、最後のステートメントでは、または評価した最後の式の戻り値です。
- 挿入されたスクリプトが型の場合
サポートされているプラットフォーム
- アマゾン火 OS
- アンドロイド
- iOS
簡単な例
var ref = window.open('http://apache.org', '_blank', 'location=yes');
ref.addEventListener('loadstop', function() {
ref.executeScript({file: "myscript.js"});
});
insertCSS
CSS に注入する、
InAppBrowserウィンドウ。
ref.insertCSS(details, callback);
-
ref: への参照を
InAppBrowserウィンドウ*(InAppBrowser)* -
injectDetails: 詳細を実行するスクリプトのいずれかを指定する、
fileまたはcodeキー。(オブジェクト)- ファイル: 注入するスタイル シートの URL。
- コード: 注入するスタイル シートのテキスト。
-
コールバック: CSS の注入後に実行される関数。
サポートされているプラットフォーム
- アマゾン火 OS
- アンドロイド
- iOS
簡単な例
var ref = window.open('http://apache.org', '_blank', 'location=yes');
ref.addEventListener('loadstop', function() {
ref.insertCSS({file: "mystyles.css"});
});