Plugin daje widok przeglądarki sieci web, które są wyświetlane podczas wywoływania cordova.InAppBrowser.open()
.
var ref = cordova.InAppBrowser.open('http://apache.org', '_blank', 'location=yes');
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");
}
cordova plugin add cordova-plugin-inappbrowser
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:
document.addEventListener("deviceready", onDeviceReady, false);
function onDeviceReady() {
window.open = 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)
adres: adres URL do ładowania (ciąg). Wywołanie encodeURI()
na to, czy adres URL zawiera znaki Unicode.
miejsce docelowe: miejsce docelowe, w którym wobec ciężar ten URL parametr opcjonalny, który domyślnie _self
. (String)
_self
: Otwiera w Cordova WebView, jeśli adres URL jest na białej liście, inaczej ono otwiera wInAppBrowser
._blank
: Otwiera wInAppBrowser
._system
: Otwiera w przeglądarce internetowej systemu.Opcje: opcje dla InAppBrowser
. Opcjonalnie, nie stawiła się: location=yes
. (String)
options
Ciąg nie może zawierać żadnych spacji, i pary nazwa/wartość każdej funkcji muszą być oddzielone przecinkami. Nazwy funkcji jest rozróżniana. Wszystkich platform obsługuje wartości poniżej:
yes
lub no
Aby włączyć InAppBrowser
na pasek lub wyłączyć.
Android:
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.yes
do przeglądarki w pamięci podręcznej plików cookie wyczyszczone zanim otworzy się nowe oknoyes
mieć w pamięci podręcznej plików cookie sesji wyczyszczone zanim otworzy się nowe okno
tylko iOS:
yes
lub no
(domyślnie no
). Włącza/wyłącza właściwość UIWebViewBounce.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.yes
do przeglądarki w pamięci podręcznej plików cookie wyczyszczone zanim otworzy się nowe oknoyes
mieć w pamięci podręcznej plików cookie sesji wyczyszczone zanim otworzy się nowe oknoyes
lub no
Aby włączyć pasek narzędzi lub wyłączyć dla InAppBrowser (domyślnieyes
)yes
lub no
Aby zapobiec rzutni skalowanie za pomocą tagu meta (domyślnieno
).yes
lub no
Aby zapobiec HTML5 audio lub wideo z Autoodtwarzanie (domyślnieno
).yes
lub no
Aby w linii HTML5 odtwarzanie, wyświetlanie w oknie przeglądarki, a nie interfejs odtwarzanie specyficzne dla urządzenia. HTML video
również musi zawierać element webkit-playsinline
atrybut (domyślnieno
)yes
lub no
Aby otworzyć klawiaturę ekranową, gdy elementy formularza ostrości za pomocą JavaScript focus()
połączenia (domyślnieyes
).yes
lub no
czekać, aż wszystkie nowe widok zawartości jest otrzymane przed renderowany (domyślnieno
).pagesheet
, formsheet
lub fullscreen
Aby ustawić styl prezentacji (domyślniefullscreen
).fliphorizontal
, crossdissolve
lub coververtical
Aby ustawić styl przejścia (domyślniecoververtical
).top
lub bottom
(domyślnie bottom
). Powoduje, że pasek ma być na górze lub na dole okna.
Windows tylko:
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.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');
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 {
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;
}
Obiekt zwrócony z wywołania cordova.InAppBrowser.open
.
Dodaje detektor zdarzenia z
InAppBrowser
.
ref.addEventListener(eventname, callback);
ref: odniesienie do InAppBrowser
okna (InAppBrowser)
EventName: zdarzenie słuchać (String)
InAppBrowser
zaczyna się ładować adresu URL.InAppBrowser
zakończeniu ładowania adresu URL.InAppBrowser
napotka błąd podczas ładowania adresu URL.InAppBrowser
okno jest zamknięte.wywołania zwrotnego: funkcja, która wykonuje, gdy zdarzenie. Funkcja jest przekazywany InAppBrowserEvent
obiektu jako parametr.
Typ: eventname, albo loadstart
, loadstop
, loaderror
, lub exit
. (String)
adres: adres URL, który został załadowany. (String)
Kod: kod błędu, tylko w przypadku loaderror
. (Liczba)
wiadomość: komunikat o błędzie, tylko w przypadku loaderror
. (String)
var ref = cordova.InAppBrowser.open('http://apache.org', '_blank', 'location=yes');
ref.addEventListener('loadstart', function(event) { alert(event.url); });
Usuwa detektor zdarzenia z
InAppBrowser
.
ref.removeEventListener(eventname, callback);
ref: odniesienie do InAppBrowser
okna. (InAppBrowser)
EventName: zdarzenie przestanie słuchać. (String)
InAppBrowser
zaczyna się ładować adresu URL.InAppBrowser
zakończeniu ładowania adresu URL.InAppBrowser
napotka błąd ładowania adresu URL.InAppBrowser
okno jest zamknięte.wywołania zwrotnego: funkcja do wykonania, gdy zdarzenie. Funkcja jest przekazywany InAppBrowserEvent
obiektu.
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);
Zamyka
InAppBrowser
okna.
ref.close();
InAppBrowser
okna (InAppBrowser)var ref = cordova.InAppBrowser.open('http://apache.org', '_blank', 'location=yes');
ref.close();
Wyświetla InAppBrowser okno, który został otwarty ukryte. Zawód ten jest ignorowany, jeśli InAppBrowser już był widoczny.
ref.show();
InAppBrowser
)var ref = cordova.InAppBrowser.open('http://apache.org', '_blank', 'hidden=yes');
// some time later...
ref.show();
Wstrzykuje kod JavaScript w
InAppBrowser
okna
ref.executeScript(details, callback);
ref: odniesienie do InAppBrowser
okna. (InAppBrowser)
injectDetails: Szczegóły dotyczące skryptu, określając albo file
lub code
klucz. (Obiekt)
wywołania zwrotnego: funkcja, która wykonuje po kod JavaScript jest wstrzykiwany.
code
, wykonuje wywołanie zwrotne z pojedynczym parametrem, który jest wartość zwracana przez skrypt, owinięte w Array
. Dla wielu linii skrypty to wartość zwracana ostatniej instrukcja, lub ostatni wyrażenie oceniane.var ref = cordova.InAppBrowser.open('http://apache.org', '_blank', 'location=yes');
ref.addEventListener('loadstop', function() {
ref.executeScript({file: "myscript.js"});
});
Wstrzykuje CSS w
InAppBrowser
okna.
ref.insertCSS(details, callback);
ref: odniesienie do InAppBrowser
okna (InAppBrowser)
injectDetails: Szczegóły dotyczące skryptu, określając albo file
lub code
klucz. (Obiekt)
wywołania zwrotnego: funkcja, która wykonuje po CSS jest wstrzykiwany.
var ref = cordova.InAppBrowser.open('http://apache.org', '_blank', 'location=yes');
ref.addEventListener('loadstop', function() {
ref.insertCSS({file: "mystyles.css"});
});