wuyi 36dc8d1c35 feat		6 years ago
..
README.md	36dc8d1c35 feat	6 years ago
index.md	36dc8d1c35 feat	6 years ago

cordova-plugin-inappbrowser

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

Instalacja

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

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)

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 yes lub no Aby włączyć InAppBrowser na pasek lub wyłączyć.
Android:
- 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
- zoom: yes aby pokazać formantami powiększania Android przeglądarka, ustawiona na nie aby je ukryć. Wartość domyślna to tak.
- hardwareback: zestaw do yes , aby użyć przycisk Wstecz sprzętu do nawigacji wstecz historii InAppBrowser. Jeśli nie ma żadnej poprzedniej strony, InAppBrowser zostanie zamknięta. Wartością domyślną jest yes, więc należy ustawić ją na no jeśli chcesz przycisk Wstecz, aby po prostu zamknąć InAppBrowser.
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 yes lub no (domyślnie no ). Włącza/wyłącza właściwość UIWebViewBounce.
- 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
- pasek narzędzi: zestaw yes lub no Aby włączyć pasek narzędzi lub wyłączyć dla InAppBrowser (domyślnieyes)
- enableViewportScale: zestaw yes lub no Aby zapobiec rzutni skalowanie za pomocą tagu meta (domyślnieno).
- mediaPlaybackRequiresUserAction: zestaw yes lub no Aby zapobiec HTML5 audio lub wideo z Autoodtwarzanie (domyślnieno).
- allowInlineMediaPlayback: zestaw 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)
- keyboardDisplayRequiresUserAction: zestaw yes lub no Aby otworzyć klawiaturę ekranową, gdy elementy formularza ostrości za pomocą JavaScript focus() połączenia (domyślnieyes).
- suppressesIncrementalRendering: zestaw yes lub no czekać, aż wszystkie nowe widok zawartości jest otrzymane przed renderowany (domyślnieno).
- presentationstyle: zestaw pagesheet , formsheet lub fullscreen Aby ustawić styl prezentacji (domyślniefullscreen).
- transitionstyle: zestaw fliphorizontal , crossdissolve lub coververtical Aby ustawić styl przejścia (domyślniecoververtical).
- toolbarposition: zestaw top lub bottom (domyślnie bottom ). Powoduje, że pasek ma być na górze lub na dole okna.
Windows tylko:
- 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.
- fullscreen: zestaw do yes , aby utworzyć formant przeglądarki bez obramowania wokół niego. Należy pamiętać, że jeśli location=no również jest określony, nie będzie żadnej kontroli przedstawione do użytkownika, aby zamknąć okno IAB.

Obsługiwane platformy

Amazon Fire OS
Android
BlackBerry 10
Firefox OS
iOS
Windows 8 i 8.1
Windows Phone 7 i 8
Przeglądarka

Przykład

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

.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;
}

Windows dziwactwa

Podobne do Firefox OS IAB okno wizualne zachowanie może być zastąpiona przez inAppBrowserWrap/inAppBrowserWrapFullscreen klas CSS

Quirks przeglądarki

Plugin jest realizowane za pośrednictwem iframe,
Historia nawigacji (przyciskiwstecz i do przodu w LocationBar) nie jest zaimplementowana.

InAppBrowser

Obiekt zwrócony z wywołania cordova.InAppBrowser.open.

Metody

metody addEventListener
removeEventListener
Zamknij
Pokaż
executeScript
insertCSS

metody addEventListener

Dodaje detektor zdarzenia zInAppBrowser.

ref.addEventListener(eventname, callback);

ref: odniesienie do InAppBrowser okna (InAppBrowser)
EventName: zdarzenie słuchać (String)
- loadstart: zdarzenie gdy odpalam InAppBrowser zaczyna się ładować adresu URL.
- loadstop: zdarzenie gdy odpalam InAppBrowser zakończeniu ładowania adresu URL.
- LoadError: zdarzenie odpala gdy InAppBrowser napotka błąd podczas ładowania adresu URL.
- wyjście: zdarzenie gdy odpalam InAppBrowser okno jest zamknięte.
wywołania zwrotnego: funkcja, która wykonuje, gdy zdarzenie. Funkcja jest przekazywany InAppBrowserEvent obiektu jako parametr.

Właściwości InAppBrowserEvent

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)

Obsługiwane platformy

Amazon Fire OS
Android
iOS
Windows 8 i 8.1
Windows Phone 7 i 8
Przeglądarka

Quirks przeglądarki

wydarzenia loadstart i loaderror nie są być opalane.

Szybki przykład

var ref = cordova.InAppBrowser.open('http://apache.org', '_blank', 'location=yes');
ref.addEventListener('loadstart', function(event) { alert(event.url); });

removeEventListener

Usuwa detektor zdarzenia zInAppBrowser.

ref.removeEventListener(eventname, callback);

ref: odniesienie do InAppBrowser okna. (InAppBrowser)
EventName: zdarzenie przestanie słuchać. (String)
- loadstart: zdarzenie gdy odpalam InAppBrowser zaczyna się ładować adresu URL.
- loadstop: zdarzenie gdy odpalam InAppBrowser zakończeniu ładowania adresu URL.
- LoadError: zdarzenie odpala gdy InAppBrowser napotka błąd ładowania adresu URL.
- wyjście: zdarzenie gdy odpalam InAppBrowser okno jest zamknięte.
wywołania zwrotnego: funkcja do wykonania, gdy zdarzenie. Funkcja jest przekazywany InAppBrowserEvent obiektu.

Obsługiwane platformy

Amazon Fire OS
Android
iOS
Windows 8 i 8.1
Windows Phone 7 i 8
Przeglądarka

Szybki przykład

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

Zamknij

Zamyka InAppBrowser okna.

ref.close();

ref: odniesienie do InAppBrowser okna (InAppBrowser)

Obsługiwane platformy

Amazon Fire OS
Android
Firefox OS
iOS
Windows 8 i 8.1
Windows Phone 7 i 8
Przeglądarka

Szybki przykład

var ref = cordova.InAppBrowser.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 (oknoInAppBrowser)

Obsługiwane platformy

Amazon Fire OS
Android
iOS
Windows 8 i 8.1
Przeglądarka

Szybki przykład

var ref = cordova.InAppBrowser.open('http://apache.org', '_blank', 'hidden=yes');
// some time later...
ref.show();

executeScript

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)
- 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 w Array . Dla wielu linii skrypty to wartość zwracana ostatniej instrukcja, lub ostatni wyrażenie oceniane.

Obsługiwane platformy

Amazon Fire OS
Android
iOS
Windows 8 i 8.1
Przeglądarka

Szybki przykład

var ref = cordova.InAppBrowser.open('http://apache.org', '_blank', 'location=yes');
ref.addEventListener('loadstop', function() {
    ref.executeScript({file: "myscript.js"});
});

Quirks przeglądarki

obsługiwany jest tylko code klucza.

Windows dziwactwa

Ze względu na MSDN dokumenty wywołany skrypt może zwracać tylko wartości ciągów, inaczej parametr, przekazywany do wywołania zwrotnego będzie [null].

insertCSS

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)
- 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
Windows

Szybki przykład

var ref = cordova.InAppBrowser.open('http://apache.org', '_blank', 'location=yes');
ref.addEventListener('loadstop', function() {
    ref.insertCSS({file: "mystyles.css"});
});

README.md

cordova-plugin-inappbrowser

Instalacja

cordova.InAppBrowser.open

Obsługiwane platformy

Przykład

Firefox OS dziwactwa

Windows dziwactwa

Quirks przeglądarki

InAppBrowser

Metody

metody addEventListener

Właściwości InAppBrowserEvent

Obsługiwane platformy

Quirks przeglądarki

Szybki przykład

removeEventListener

Obsługiwane platformy

Szybki przykład

Zamknij

Obsługiwane platformy

Szybki przykład

Pokaż

Obsługiwane platformy

Szybki przykład

executeScript

Obsługiwane platformy

Szybki przykład

Quirks przeglądarki

Windows dziwactwa

insertCSS

Obsługiwane platformy

Szybki przykład