apache-cordova-plugin-inappbrowser/doc/ja/index.md

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 または no InAppBrowser (デフォルトのツールバーのオンまたはオフを有効にするには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： イベントが発生するとき、 InAppBrowser URL の読み込みが完了します。
  • loaderror： イベントが発生するとき、 InAppBrowser URL の読み込みでエラーが発生します。
  • 終了: イベントが発生するとき、 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： イベントが発生するとき、 InAppBrowser URL の読み込みが完了します。
  • loaderror： イベントが発生するとき、 InAppBrowser URL の読み込みエラーが発生します。
  • 終了: イベントが発生するとき、 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"});
});