CB-8438 cordova-plugin-inappbrowser documentation translation: cordova-plugin-inappbrowser

This commit is contained in:
Victor Sosa
2015-02-27 12:51:38 -06:00
parent fb8574abde
commit 4a4164c6f6
8 changed files with 410 additions and 194 deletions
+45 -18
View File
@@ -19,23 +19,51 @@
# org.apache.cordova.inappbrowser
Plugin daje widok przeglądarki sieci web, które są wyświetlane podczas wywoływania`window.open()`.
Plugin daje widok przeglądarki sieci web, które są wyświetlane podczas wywoływania `cordova.InAppBrowser.open()`.
var ref = window.open('http://apache.org', '_blank', 'location=yes');
var ref = cordova.InAppBrowser.open('http://apache.org', '_blank', 'location=yes');
**Uwaga**: The InAppBrowser okno zachowuje się jak standardowe przeglądarki, a nie ma dostępu do API Cordova.
`cordova.InAppBrowser.open()` funkcja jest definiowana jako zamiennik dla funkcji `window.open()`. Istniejące wywołania `window.open()` służy okno InAppBrowser, zastępując window.open:
window.open = cordova.InAppBrowser.open;
Okna InAppBrowser zachowuje się jak standardowe przeglądarki i nie ma dostępu do API Cordova. Z tego powodu zaleca się InAppBrowser jeśli ty potrzebować wobec ciężar (niezaufanej) treści osób trzecich, a nie że wczytywanie głównym webview Cordova. InAppBrowser nie jest biała, ani nie jest otwieranie linków w przeglądarce systemu.
InAppBrowser zawiera domyślnie kontrole GUI dla użytkownika (tył, przód, zrobić).
Do tyłu zgodności, ten plugin również haki `window.open`. Jednak może mieć zainstalowane wtyczki haka `window.open` niezamierzone skutki uboczne (zwłaszcza, jeśli ten plugin jest włączone tylko jako część innej wtyczki). Hak `window.open` zostaną usunięte w przyszłej wersji głównych. Dopóki hak jest usuwany z wtyczki, aplikacje można ręcznie przywrócić domyślne zachowanie:
delete window.open // Reverts the call back to it's prototype's default
Chociaż `window.open` w globalnym zasięgu, InAppBrowser nie jest dostępne dopiero po zdarzeniu `deviceready`.
document.addEventListener("deviceready", onDeviceReady, false);
function onDeviceReady() {
console.log("window.open works well");
}
## Instalacja
cordova plugin add org.apache.cordova.inappbrowser
## window.open
Jeśli chcesz wszystko stronica ładunki w swojej aplikacji, aby przejść przez InAppBrowser, można po prostu podłączyć `window.open` podczas inicjowania. Na przykład:
Otwiera URL w nowym `InAppBrowser` wystąpienie, bieżące wystąpienie przeglądarki lub przeglądarki systemu.
document.addEventListener("deviceready", onDeviceReady, false);
function onDeviceReady() {
window.open = cordova.InAppBrowser.open;
}
var ref = window.open(url, target, options);
## cordova.InAppBrowser.open
Otwiera URL w nowe wystąpienie `InAppBrowser`, bieżące wystąpienie przeglądarki lub przeglądarki systemu.
var ref = cordova.InAppBrowser.open(url, target, options);
* **ref**: odniesienie do `InAppBrowser` okna. *(InAppBrowser)*
@@ -56,7 +84,6 @@ Otwiera URL w nowym `InAppBrowser` wystąpienie, bieżące wystąpienie przeglą
Android:
* **closebuttoncaption**: aby użyć jak **zrobić** przycisk Podpis ustawiona na ciąg.
* **ukryte**: zestaw `yes` do stworzenia przeglądarki i ładowania strony, ale nie pokazuje go. Loadstop zdarzenie fires po zakończeniu ładowania. Pominąć lub zestaw `no` (domyślnie) do przeglądarki otworzyć i załadować normalnie.
* **ClearCache**: zestaw `yes` do przeglądarki w pamięci podręcznej plików cookie wyczyszczone zanim otworzy się nowe okno
* **clearsessioncache**: zestaw `yes` mieć w pamięci podręcznej plików cookie sesji wyczyszczone zanim otworzy się nowe okno
@@ -97,13 +124,13 @@ Otwiera URL w nowym `InAppBrowser` wystąpienie, bieżące wystąpienie przeglą
### Przykład
var ref = window.open('http://apache.org', '_blank', 'location=yes');
var ref2 = window.open(encodeURI('http://ja.m.wikipedia.org/wiki/ハングル'), '_blank', 'location=yes');
var ref = cordova.InAppBrowser.open('http://apache.org', '_blank', 'location=yes');
var ref2 = cordova.InAppBrowser.open(encodeURI('http://ja.m.wikipedia.org/wiki/ハングル'), '_blank', 'location=yes');
### Firefox OS dziwactwa
Jak plugin nie wymuszać każdy projekt to trzeba dodać pewne reguły CSS jeśli otwarty z `target='_blank'` . Zasady może wyglądać jak te
Jak plugin nie wymuszać każdy projekt to trzeba dodać pewne reguły CSS jeśli otwarty z `target = "_blank"`. Zasady może wyglądać jak te
css
.inAppBrowserWrap {
@@ -133,7 +160,7 @@ Jak plugin nie wymuszać każdy projekt to trzeba dodać pewne reguły CSS jeśl
## InAppBrowser
Obiekt zwrócony z wywołania`window.open`.
Obiekt zwrócony z wywołania `cordova.InAppBrowser.open`.
### Metody
@@ -182,7 +209,7 @@ Obiekt zwrócony z wywołania`window.open`.
### Szybki przykład
var ref = window.open('http://apache.org', '_blank', 'location=yes');
var ref = cordova.InAppBrowser.open('http://apache.org', '_blank', 'location=yes');
ref.addEventListener('loadstart', function(event) { alert(event.url); });
@@ -214,7 +241,7 @@ Obiekt zwrócony z wywołania`window.open`.
### Szybki przykład
var ref = window.open('http://apache.org', '_blank', 'location=yes');
var ref = cordova.InAppBrowser.open('http://apache.org', '_blank', 'location=yes');
var myCallback = function(event) { alert(event.url); }
ref.addEventListener('loadstart', myCallback);
ref.removeEventListener('loadstart', myCallback);
@@ -224,7 +251,7 @@ Obiekt zwrócony z wywołania`window.open`.
> Zamyka `InAppBrowser` okna.
ref.Close();
ref.close();
* **ref**: odniesienie do `InAppBrowser` okna *(InAppBrowser)*
@@ -240,7 +267,7 @@ Obiekt zwrócony z wywołania`window.open`.
### Szybki przykład
var ref = window.open('http://apache.org', '_blank', 'location=yes');
var ref = cordova.InAppBrowser.open('http://apache.org', '_blank', 'location=yes');
ref.close();
@@ -262,7 +289,7 @@ Obiekt zwrócony z wywołania`window.open`.
### Szybki przykład
var ref = window.open('http://apache.org', '_blank', 'hidden=yes');
var ref = cordova.InAppBrowser.open('http://apache.org', '_blank', 'hidden=yes');
// some time later...
ref.show();
@@ -294,7 +321,7 @@ Obiekt zwrócony z wywołania`window.open`.
### Szybki przykład
var ref = window.open('http://apache.org', '_blank', 'location=yes');
var ref = cordova.InAppBrowser.open('http://apache.org', '_blank', 'location=yes');
ref.addEventListener('loadstop', function() {
ref.executeScript({file: "myscript.js"});
});
@@ -324,7 +351,7 @@ Obiekt zwrócony z wywołania`window.open`.
### Szybki przykład
var ref = window.open('http://apache.org', '_blank', 'location=yes');
var ref = cordova.InAppBrowser.open('http://apache.org', '_blank', 'location=yes');
ref.addEventListener('loadstop', function() {
ref.insertCSS({file: "mystyles.css"});
});