12 KiB
org.apache.cordova.inappbrowser
Plugin daje widok przeglądarki sieci web, które są wyświetlane podczas wywoływaniawindow.open().
var ref = window.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.
Instalacja
cordova plugin add org.apache.cordova.inappbrowser
window.open
Otwiera URL w nowym InAppBrowser wystąpienie, bieżące wystąpienie przeglądarki lub przeglądarki systemu.
var ref = window.open(url, target, options);
-
ref: odniesienie do
InAppBrowserokna. (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)optionsCią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:- Lokalizacja: zestaw
yeslubnoAby włączyćInAppBrowserna pasek lub wyłączyć.
Android:
- closebuttoncaption: aby użyć jak zrobić przycisk Podpis ustawiona na ciąg.
- ukryte: zestaw
yesdo stworzenia przeglądarki i ładowania strony, ale nie pokazuje go. Loadstop zdarzenie fires po zakończeniu ładowania. Pominąć lub zestawno(domyślnie) do przeglądarki otworzyć i załadować normalnie. - ClearCache: zestaw
yesdo przeglądarki w pamięci podręcznej plików cookie wyczyszczone zanim otworzy się nowe okno - clearsessioncache: zestaw
yesmieć w pamięci podręcznej plików cookie sesji wyczyszczone zanim otworzy się nowe okno
tylko iOS:
- closebuttoncaption: aby użyć jak zrobić przycisk Podpis ustawiona na ciąg. Należy pamiętać, że trzeba zlokalizować tę wartość siebie.
- disallowoverscroll: zestaw
yeslubno(domyślnieno). Włącza/wyłącza właściwość UIWebViewBounce. - ukryte: zestaw
yesdo stworzenia przeglądarki i ładowania strony, ale nie pokazuje go. Loadstop zdarzenie fires po zakończeniu ładowania. Pominąć lub zestawno(domyślnie) do przeglądarki otworzyć i załadować normalnie. - ClearCache: zestaw
yesdo przeglądarki w pamięci podręcznej plików cookie wyczyszczone zanim otworzy się nowe okno - clearsessioncache: zestaw
yesmieć w pamięci podręcznej plików cookie sesji wyczyszczone zanim otworzy się nowe okno - pasek narzędzi: zestaw
yeslubnoAby włączyć pasek narzędzi lub wyłączyć dla InAppBrowser (domyślnieyes) - enableViewportScale: zestaw
yeslubnoAby zapobiec rzutni skalowanie za pomocą tagu meta (domyślnieno). - mediaPlaybackRequiresUserAction: zestaw
yeslubnoAby zapobiec HTML5 audio lub wideo z Autoodtwarzanie (domyślnieno). - allowInlineMediaPlayback: zestaw
yeslubnoAby w linii HTML5 odtwarzanie, wyświetlanie w oknie przeglądarki, a nie interfejs odtwarzanie specyficzne dla urządzenia. HTMLvideorównież musi zawierać elementwebkit-playsinlineatrybut (domyślnieno) - keyboardDisplayRequiresUserAction: zestaw
yeslubnoAby otworzyć klawiaturę ekranową, gdy elementy formularza ostrości za pomocą JavaScriptfocus()połączenia (domyślnieyes). - suppressesIncrementalRendering: zestaw
yeslubnoczekać, aż wszystkie nowe widok zawartości jest otrzymane przed renderowany (domyślnieno). - presentationstyle: zestaw
pagesheet,formsheetlubfullscreenAby ustawić styl prezentacji (domyślniefullscreen). - transitionstyle: zestaw
fliphorizontal,crossdissolvelubcoververticalAby ustawić styl przejścia (domyślniecoververtical). - toolbarposition: zestaw
toplubbottom(domyślniebottom). Powoduje, że pasek ma być na górze lub na dole okna.
Windows tylko:
- ukryte: zestaw
yesdo stworzenia przeglądarki i ładowania strony, ale nie pokazuje go. Loadstop zdarzenie fires po zakończeniu ładowania. Pominąć lub zestawno(domyślnie) do przeglądarki otworzyć i załadować normalnie.
- Lokalizacja: zestaw
Obsługiwane platformy
- Amazon Fire OS
- Android
- BlackBerry 10
- Firefox OS
- iOS
- Windows 8 i 8.1
- Windows Phone 7 i 8
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');
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
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
Obiekt zwrócony z wywołaniawindow.open.
Metody
- metody addEventListener
- removeEventListener
- Zamknij
- Pokaż
- executeScript
- insertCSS
metody addEventListener
Dodaje detektor zdarzenia z
InAppBrowser.
ref.addEventListener(eventname, callback);
-
ref: odniesienie do
InAppBrowserokna (InAppBrowser) -
EventName: zdarzenie słuchać (String)
- loadstart: zdarzenie gdy odpalam
InAppBrowserzaczyna się ładować adresu URL. - loadstop: zdarzenie gdy odpalam
InAppBrowserzakończeniu ładowania adresu URL. - LoadError: zdarzenie odpala gdy
InAppBrowsernapotka błąd podczas ładowania adresu URL. - wyjście: zdarzenie gdy odpalam
InAppBrowserokno jest zamknięte.
- loadstart: zdarzenie gdy odpalam
-
wywołania zwrotnego: funkcja, która wykonuje, gdy zdarzenie. Funkcja jest przekazywany
InAppBrowserEventobiektu jako parametr.
Właściwości InAppBrowserEvent
-
Typ: eventname, albo
loadstart,loadstop,loaderror, lubexit. (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)
Obsługiwane platformy
- Amazon Fire OS
- Android
- iOS
- Windows 8 i 8.1
- Windows Phone 7 i 8
Szybki przykład
var ref = window.open('http://apache.org', '_blank', 'location=yes');
ref.addEventListener('loadstart', function(event) { alert(event.url); });
removeEventListener
Usuwa detektor zdarzenia z
InAppBrowser.
ref.removeEventListener(eventname, callback);
-
ref: odniesienie do
InAppBrowserokna. (InAppBrowser) -
EventName: zdarzenie przestanie słuchać. (String)
- loadstart: zdarzenie gdy odpalam
InAppBrowserzaczyna się ładować adresu URL. - loadstop: zdarzenie gdy odpalam
InAppBrowserzakończeniu ładowania adresu URL. - LoadError: zdarzenie odpala gdy
InAppBrowsernapotka błąd ładowania adresu URL. - wyjście: zdarzenie gdy odpalam
InAppBrowserokno jest zamknięte.
- loadstart: zdarzenie gdy odpalam
-
wywołania zwrotnego: funkcja do wykonania, gdy zdarzenie. Funkcja jest przekazywany
InAppBrowserEventobiektu.
Obsługiwane platformy
- Amazon Fire OS
- Android
- iOS
- Windows 8 i 8.1
- Windows Phone 7 i 8
Szybki przykład
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);
Zamknij
Zamyka
InAppBrowserokna.
ref.Close();
- ref: odniesienie do
InAppBrowserokna (InAppBrowser)
Obsługiwane platformy
- Amazon Fire OS
- Android
- Firefox OS
- iOS
- Windows 8 i 8.1
- Windows Phone 7 i 8
Szybki przykład
var ref = window.open('http://apache.org', '_blank', 'location=yes');
ref.close();
Pokaż
Wyświetla InAppBrowser okno, który został otwarty ukryte. Zawód ten jest ignorowany, jeśli InAppBrowser już był widoczny.
ref.show();
- ref: odwołanie do InAppBrowser (okno
InAppBrowser)
Obsługiwane platformy
- Amazon Fire OS
- Android
- iOS
- Windows 8 i 8.1
Szybki przykład
var ref = window.open('http://apache.org', '_blank', 'hidden=yes');
// some time later...
ref.show();
executeScript
Wstrzykuje kod JavaScript w
InAppBrowserokna
ref.executeScript(details, callback);
-
ref: odniesienie do
InAppBrowserokna. (InAppBrowser) -
injectDetails: Szczegóły dotyczące skryptu, określając albo
filelubcodeklucz. (Obiekt)- plik: adres URL skryptu, aby wstrzyknąć.
- Kod: tekst skryptu, aby wstrzyknąć.
-
wywołania zwrotnego: funkcja, która wykonuje po kod JavaScript jest wstrzykiwany.
- Jeśli taki skrypt jest typu
code, wykonuje wywołanie zwrotne z pojedynczym parametrem, który jest wartość zwracana przez skrypt, owinięte wArray. Dla wielu linii skrypty to wartość zwracana ostatniej instrukcja, lub ostatni wyrażenie oceniane.
- Jeśli taki skrypt jest typu
Obsługiwane platformy
- Amazon Fire OS
- Android
- iOS
- Windows 8 i 8.1
Szybki przykład
var ref = window.open('http://apache.org', '_blank', 'location=yes');
ref.addEventListener('loadstop', function() {
ref.executeScript({file: "myscript.js"});
});
insertCSS
Wstrzykuje CSS w
InAppBrowserokna.
ref.insertCSS(details, callback);
-
ref: odniesienie do
InAppBrowserokna (InAppBrowser) -
injectDetails: Szczegóły dotyczące skryptu, określając albo
filelubcodeklucz. (Obiekt)- plik: URL arkusza stylów do wsuwania.
- Kod: tekst z arkusza stylów do wstrzykiwania.
-
wywołania zwrotnego: funkcja, która wykonuje po CSS jest wstrzykiwany.
Obsługiwane platformy
- Amazon Fire OS
- Android
- iOS
Szybki przykład
var ref = window.open('http://apache.org', '_blank', 'location=yes');
ref.addEventListener('loadstop', function() {
ref.insertCSS({file: "mystyles.css"});
});