This repository has been archived on 2023-02-21. You can view files and clone it, but cannot push or open issues or pull requests.
momo/plugins/org.apache.cordova.inappbro.../doc/ja/index.md

15 KiB
Raw Blame History

org.apache.cordova.inappbrowser

このプラグインを呼び出すときに表示される web ブラウザーのビューを提供しますwindow.open().

var ref = window.open('http://apache.org', '_blank', 'location=yes');

: ウィンドウの動作、InAppBrowser 標準的な web ブラウザーのようとコルドバの Api にアクセスできません。

インストール

cordova plugin add org.apache.cordova.inappbrowser

window.open

新しい URL を開き InAppBrowser インスタンス、現在のブラウザー インスタンスまたはシステムのブラウザー。

var ref = window.open(url, target, options);
  • 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 に設定されている pagesheetformsheet または fullscreen (デフォルトでは、プレゼンテーション スタイルを設定するにはfullscreen).
    • transitionstyle に設定されている fliphorizontalcrossdissolve または coververtical (デフォルトでは、トランジションのスタイルを設定するにはcoververtical).
    • toolbarposition に設定されている top または bottom (既定値は bottom )。上部またはウィンドウの下部にツールバーが発生します。

    Windows のみ:

    • 非表示: 設定 yes ブラウザーを作成して、ページの読み込みが表示されません。 Loadstop イベントは、読み込みが完了すると発生します。 省略するか設定 no (既定値) を開くし、通常読み込みブラウザーを持っています。

サポートされているプラットフォーム

  • アマゾン火 OS
  • アンドロイド
  • ブラックベリー 10
  • Firefox の OS
  • iOS
  • Windows 8 および 8.1
  • 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');

Firefox OS 癖

開かれた場合にいくつかの CSS ルールを追加する必要があるプラグインは任意のデザインを適用しないよう target='_blank' 。これらのような規則になります。

 css
.inAppBrowserWrap {
  background-color: rgba(0,0,0,0.75);
  color: rgba(235,235,235,1.0);
}
.inAppBrowserWrap menu {
  overflow: auto;
  list-style-type: none;
  padding-left: 0;
}
.inAppBrowserWrap menu li {
  font-size: 25px;
  height: 25px;
  float: left;
  margin: 0 10px;
  padding: 3px 10px;
  text-decoration: none;
  color: #ccc;
  display: block;
  background: rgba(30,30,30,0.50);
}
.inAppBrowserWrap menu li.disabled {
    color: #777;
}

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 どちらか loadstartloadstoploaderror 、または exit(文字列)

  • url: URL が読み込まれました。(文字列)

  • コード: の場合にのみ、エラー コード loaderror(数)

  • メッセージ: の場合にのみ、エラー メッセージ loaderror(文字列)

サポートされているプラットフォーム

  • アマゾン火 OS
  • アンドロイド
  • iOS
  • Windows 8 および 8.1
  • 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 8 および 8.1
  • 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
  • アンドロイド
  • Firefox の OS
  • iOS
  • Windows 8 および 8.1
  • 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
  • Windows 8 および 8.1

簡単な例

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
  • Windows 8 および 8.1

簡単な例

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"});
});