12 KiB
org.apache.cordova.inappbrowser
Dieses Plugin bietet eine Web-Browser-Ansicht, die anzeigt, beim Aufrufen von window.open() , oder als als bildeten einen Link öffnen<a target="_blank">.
var ref = window.open('http://apache.org', '_blank', 'location=yes');
Hinweis: die InAppBrowser Fenster verhält sich wie einen standard-Webbrowser und Cordova APIs kann nicht zugegriffen werden kann.
Installation
cordova plugin add org.apache.cordova.inappbrowser
window.open
Öffnet eine URL in einem neuen InAppBrowser Instanz, die aktuelle Browserinstanz oder der Systembrowser.
var ref = window.open(url, target, options);
-
Ref: Bezugnahme auf die
InAppBrowserFenster. (InAppBrowser) -
URL: die URL *(String)*zu laden. Rufen Sie
encodeURI()auf diese Option, wenn die URL enthält Unicode-Zeichen. -
Ziel: das Ziel in der URL, einen optionalen Parameter geladen, die standardmäßig auf
_self. (String)_self: Öffnet sich in der Cordova WebView wenn der URL in der Whitelist ist, andernfalls es öffnet sich in derInAppBrowser._blank: Öffnet denInAppBrowser._system: Öffnet in den System-Web-Browser.
-
Optionen: Optionen für die
InAppBrowser. Optional, säumige an:location=yes. (String)Die
optionsZeichenfolge muss keine Leerstelle enthalten, und jede Funktion Name/Wert-Paare müssen durch ein Komma getrennt werden. Featurenamen Groß-/Kleinschreibung. Alle Plattformen unterstützen die anderen Werte:- Lage: Legen Sie auf
yesoderno, machen dieInAppBrowserder Adressleiste ein- oder ausschalten.
Nur Android:
- Closebuttoncaption: Legen Sie auf eine Zeichenfolge als Beschriftung der fertig -Schaltfläche verwenden.
- versteckte: Legen Sie auf
yesum den Browser zu erstellen und laden Sie die Seite, aber nicht zeigen. Das Loadstop-Ereignis wird ausgelöst, wenn der Ladevorgang abgeschlossen ist. Weglassen oder aufno(Standard), den Browser öffnen und laden normalerweise zu haben. - ClearCache: Legen Sie auf
yes, der Browser ist Cookiecache gelöscht, bevor das neue Fenster geöffnet wird - Clearsessioncache: Legen Sie auf
yes, der Sitzungs-Cookie Cache gelöscht, bevor das neue Fenster geöffnet wird
iOS nur:
- Closebuttoncaption: Legen Sie auf eine Zeichenfolge als Beschriftung der fertig -Schaltfläche verwenden. Beachten Sie, dass Sie diesen Wert selbst zu lokalisieren müssen.
- Disallowoverscroll: Legen Sie auf
yesoderno(Standard istno). Aktiviert/deaktiviert die UIWebViewBounce-Eigenschaft. - versteckte: Legen Sie auf
yesum den Browser zu erstellen und laden Sie die Seite, aber nicht zeigen. Das Loadstop-Ereignis wird ausgelöst, wenn der Ladevorgang abgeschlossen ist. Weglassen oder aufno(Standard), den Browser öffnen und laden normalerweise zu haben. - ClearCache: Legen Sie auf
yes, der Browser ist Cookiecache gelöscht, bevor das neue Fenster geöffnet wird - Clearsessioncache: Legen Sie auf
yeszu der Session Cookie Cache gelöscht, bevor das neue Fenster geöffnet wird - Symbolleiste: Legen Sie auf
yesodernoAktivieren Sie die Symbolleiste ein- oder Ausschalten für InAppBrowser (Standard:yes) - EnableViewportScale: Legen Sie auf
yesoderno, Viewport Skalierung durch ein Meta-Tag (standardmäßig zu verhindernno). - MediaPlaybackRequiresUserAction: Legen Sie auf
yesoderno, HTML5 audio oder video von automatisches Abspielen (standardmäßig zu verhindernno). - AllowInlineMediaPlayback: Legen Sie auf
yesodernoInline-HTML5-Media-Wiedergabe, Darstellung im Browser-Fenster, sondern in eine gerätespezifische Wiedergabe-Schnittstelle ermöglichen. Des HTMLvideoElement muss auch diewebkit-playsinlineAttribut (Standard:no) - KeyboardDisplayRequiresUserAction: Legen Sie auf
yesodernoum die Tastatur zu öffnen, wenn Formularelemente Fokus per JavaScript erhaltenfocus()Anruf (Standard:yes). - SuppressesIncrementalRendering: Legen Sie auf
yesodernozu warten, bis alle neuen anzeigen-Inhalte empfangen wird, bevor Sie wiedergegeben wird (standardmäßigno). - Presentationstyle: Legen Sie auf
pagesheet,formsheetoderfullscreenPräsentationsstil (standardmäßig festfullscreen). - Transitionstyle: Legen Sie auf
fliphorizontal,crossdissolveodercoververticalÜbergangsstil (standardmäßig festcoververtical). - Toolbarposition: Legen Sie auf
topoderbottom(Standard istbottom). Bewirkt, dass die Symbolleiste am oberen oder unteren Rand des Fensters sein.
- Lage: Legen Sie auf
Unterstützte Plattformen
- Amazon Fire OS
- Android
- BlackBerry 10
- Firefox OS
- iOS
- Windows Phone 7 und 8
Beispiel
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 Macken
Als Plugin jedes Design erzwingen nicht besteht die Notwendigkeit, einige CSS-Regeln hinzuzufügen, wenn bei target='_blank' . Die Regeln könnte wie diese aussehen.
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
Aus einem Aufruf zurückgegebenen Objektswindow.open.
Methoden
- addEventListener
- removeEventListener
- Schließen
- Karte
- executeScript
- insertCSS
addEventListener
Fügt einen Listener für eine Veranstaltung aus der
InAppBrowser.
ref.addEventListener(eventname, callback);
-
Ref: Bezugnahme auf die
InAppBrowserFenster (InAppBrowser) -
EventName: das Ereignis zu warten (String)
- Loadstart: Ereignis wird ausgelöst, wenn die
InAppBrowserbeginnt, eine URL zu laden. - Loadstop: Ereignis wird ausgelöst, wenn der
InAppBrowserbeendet ist, eine URL laden. - LoadError: Ereignis wird ausgelöst, wenn der
InAppBrowserein Fehler auftritt, wenn Sie eine URL zu laden. - Ausfahrt: Ereignis wird ausgelöst, wenn das
InAppBrowser-Fenster wird geschlossen.
- Loadstart: Ereignis wird ausgelöst, wenn die
-
Rückruf: die Funktion, die ausgeführt wird, wenn das Ereignis ausgelöst wird. Die Funktion übergeben wird ein
InAppBrowserEvent-Objekt als Parameter.
InAppBrowserEvent Eigenschaften
-
Typ: Eventname, entweder
loadstart,loadstop,loaderror, oderexit. (String) -
URL: die URL, die geladen wurde. (String)
-
Code: der Fehler-Code, nur im Fall von
loaderror. (Anzahl) -
Nachricht: die Fehlermeldung angezeigt, nur im Fall von
loaderror. (String)
Unterstützte Plattformen
- Amazon Fire OS
- Android
- iOS
- Windows Phone 7 und 8
Kleines Beispiel
var ref = window.open('http://apache.org', '_blank', 'location=yes');
ref.addEventListener('loadstart', function(event) { alert(event.url); });
removeEventListener
Entfernt einen Listener für eine Veranstaltung aus der
InAppBrowser.
ref.removeEventListener(eventname, callback);
-
Ref: Bezugnahme auf die
InAppBrowserFenster. (InAppBrowser) -
EventName: das Ereignis zu warten. (String)
- Loadstart: Ereignis wird ausgelöst, wenn die
InAppBrowserbeginnt, eine URL zu laden. - Loadstop: Ereignis wird ausgelöst, wenn der
InAppBrowserbeendet ist, eine URL laden. - LoadError: Ereignis wird ausgelöst, wenn die
InAppBrowsertrifft einen Fehler beim Laden einer URLs. - Ausfahrt: Ereignis wird ausgelöst, wenn das
InAppBrowser-Fenster wird geschlossen.
- Loadstart: Ereignis wird ausgelöst, wenn die
-
Rückruf: die Funktion ausgeführt, wenn das Ereignis ausgelöst wird. Die Funktion übergeben wird ein
InAppBrowserEventObjekt.
Unterstützte Plattformen
- Amazon Fire OS
- Android
- iOS
- Windows Phone 7 und 8
Kleines Beispiel
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);
Schließen
Schließt die
InAppBrowserFenster.
Ref.Close();
- Ref: Bezugnahme auf die
InAppBrowserFenster (InAppBrowser)
Unterstützte Plattformen
- Amazon Fire OS
- Android
- Firefox OS
- iOS
- Windows Phone 7 und 8
Kleines Beispiel
var ref = window.open('http://apache.org', '_blank', 'location=yes');
ref.close();
Karte
Zeigt ein InAppBrowser-Fenster, das geöffnet wurde, versteckt. Aufrufen, dies hat keine Auswirkungen, wenn die InAppBrowser schon sichtbar war.
Ref.Show();
- Ref: Verweis auf die (InAppBrowser) Fenster
InAppBrowser)
Unterstützte Plattformen
- Amazon Fire OS
- Android
- iOS
Kleines Beispiel
var ref = window.open('http://apache.org', '_blank', 'hidden=yes');
// some time later...
ref.show();
executeScript
Fügt JavaScript-Code in das
InAppBrowserFenster
ref.executeScript(details, callback);
-
Ref: Bezugnahme auf die
InAppBrowserFenster. (InAppBrowser) -
InjectDetails: Informationen über das Skript ausgeführt, angeben, entweder ein
fileodercodeSchlüssel. (Objekt)- Datei: URL des Skripts zu injizieren.
- Code: Text des Skripts zu injizieren.
-
Rückruf: die Funktion, die ausgeführt wird, nachdem der JavaScript-Code injiziert wird.
- Wenn das eingefügte Skript vom Typ ist
code, der Rückruf führt mit einen einzelnen Parameter, der der Rückgabewert des Skripts ist, umwickelt einArray. Bei Multi-Line-Skripten ist der Rückgabewert von der letzten Anweisung oder den letzten Ausdruck ausgewertet.
- Wenn das eingefügte Skript vom Typ ist
Unterstützte Plattformen
- Amazon Fire OS
- Android
- iOS
Kleines Beispiel
var ref = window.open('http://apache.org', '_blank', 'location=yes');
ref.addEventListener('loadstop', function() {
ref.executeScript({file: "myscript.js"});
});
insertCSS
Injiziert CSS in der
InAppBrowserFenster.
ref.insertCSS(details, callback);
-
Ref: Bezugnahme auf die
InAppBrowserFenster (InAppBrowser) -
InjectDetails: Informationen über das Skript ausgeführt, angeben, entweder ein
fileodercodeSchlüssel. (Objekt)- Datei: URL des Stylesheets zu injizieren.
- Code: Text des Stylesheets zu injizieren.
-
Rückruf: die Funktion, die ausgeführt wird, nachdem die CSS injiziert wird.
Unterstützte Plattformen
- Amazon Fire OS
- Android
- iOS
Kleines Beispiel
var ref = window.open('http://apache.org', '_blank', 'location=yes');
ref.addEventListener('loadstop', function() {
ref.insertCSS({file: "mystyles.css"});
});