apache-cordova-plugin-inappbrowser/doc/de/index.md

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

Firefox OS

Erstellen Sie www/manifest.webapp , wie in Docs Manifestbeschrieben. Fügen Sie die entsprechenden Permisions.

"permissions": {
    "browser": {}
}

window.open

Öffnet eine URL in einem neuen InAppBrowser Instanz, die aktuelle Browserinstanz oder der Systembrowser.

Var Ref = window.open (Url, Ziel, Optionen);

• Ref: Bezugnahme auf die InAppBrowser Fenster. (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 options Zeichenfolge 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 yes oder no , machen die InAppBrowser der Adressleiste ein- oder ausschalten.

  Nur Android:

  • Closebuttoncaption: Legen Sie auf eine Zeichenfolge als Beschriftung der fertig -Schaltfläche verwenden.
  • versteckte: Legen Sie auf yes um 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 auf no (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 yes oder no (Standard ist no ). Aktiviert/deaktiviert die UIWebViewBounce-Eigenschaft.
  • versteckte: Legen Sie auf yes um 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 auf no (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 zu der Session Cookie Cache gelöscht, bevor das neue Fenster geöffnet wird
  • Symbolleiste: Legen Sie auf yes oder no Aktivieren Sie die Symbolleiste ein- oder Ausschalten für InAppBrowser (Standard:yes)
  • EnableViewportScale: Legen Sie auf yes oder no , Viewport Skalierung durch ein Meta-Tag (standardmäßig zu verhindernno).
  • MediaPlaybackRequiresUserAction: Legen Sie auf yes oder no , HTML5 audio oder video von automatisches Abspielen (standardmäßig zu verhindernno).
  • AllowInlineMediaPlayback: Legen Sie auf yes oder no Inline-HTML5-Media-Wiedergabe, Darstellung im Browser-Fenster, sondern in eine gerätespezifische Wiedergabe-Schnittstelle ermöglichen. Des HTML video Element muss auch die webkit-playsinline Attribut (Standard:no)
  • KeyboardDisplayRequiresUserAction: Legen Sie auf yes oder no um die Tastatur zu öffnen, wenn Formularelemente Fokus per JavaScript erhalten focus() Anruf (Standard:yes).
  • SuppressesIncrementalRendering: Legen Sie auf yes oder no zu warten, bis alle neuen anzeigen-Inhalte empfangen wird, bevor Sie wiedergegeben wird (standardmäßigno).
  • Presentationstyle: Legen Sie auf pagesheet , formsheet oder fullscreen Präsentationsstil (standardmäßig festfullscreen).
  • Transitionstyle: Legen Sie auf fliphorizontal , crossdissolve oder coververtical Übergangsstil (standardmäßig festcoververtical).
  • Toolbarposition: Legen Sie auf top oder bottom (Standard ist bottom ). Bewirkt, dass die Symbolleiste am oberen oder unteren Rand des Fensters sein.

Unterstützte Plattformen

• Amazon Fire OS
• Android
• BlackBerry 10
• 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');

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 derInAppBrowser.

ref.addEventListener(eventname, callback);

• Ref: Bezugnahme auf die InAppBrowser Fenster (InAppBrowser)

• EventName: das Ereignis zu warten (String)

  • Loadstart: Ereignis wird ausgelöst, wenn die InAppBrowser beginnt, eine URL zu laden.
  • Loadstop: Ereignis wird ausgelöst, wenn der InAppBrowser beendet ist, eine URL laden.
  • LoadError: Ereignis wird ausgelöst, wenn der InAppBrowser ein Fehler auftritt, wenn Sie eine URL zu laden.
  • Ausfahrt: Ereignis wird ausgelöst, wenn das InAppBrowser -Fenster wird geschlossen.

• 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 , oder exit . (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 derInAppBrowser.

ref.removeEventListener(eventname, callback);

• Ref: Bezugnahme auf die InAppBrowser Fenster. (InAppBrowser)

• EventName: das Ereignis zu warten. (String)

  • Loadstart: Ereignis wird ausgelöst, wenn die InAppBrowser beginnt, eine URL zu laden.
  • Loadstop: Ereignis wird ausgelöst, wenn der InAppBrowser beendet ist, eine URL laden.
  • LoadError: Ereignis wird ausgelöst, wenn die InAppBrowser trifft einen Fehler beim Laden einer URLs.
  • Ausfahrt: Ereignis wird ausgelöst, wenn das InAppBrowser -Fenster wird geschlossen.

• Rückruf: die Funktion ausgeführt, wenn das Ereignis ausgelöst wird. Die Funktion übergeben wird ein InAppBrowserEvent Objekt.

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 InAppBrowser Fenster.

Ref.Close();

• Ref: Bezugnahme auf die InAppBrowser Fenster (InAppBrowser)

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.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) FensterInAppBrowser)

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 InAppBrowser Fenster

ref.executeScript(details, callback);

• Ref: Bezugnahme auf die InAppBrowser Fenster. (InAppBrowser)

• InjectDetails: Informationen über das Skript ausgeführt, angeben, entweder ein file oder code Schlü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 ein Array . Bei Multi-Line-Skripten ist der Rückgabewert von der letzten Anweisung oder den letzten Ausdruck ausgewertet.

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 InAppBrowser Fenster.

ref.insertCSS(details, callback);

• Ref: Bezugnahme auf die InAppBrowser Fenster (InAppBrowser)

• InjectDetails: Informationen über das Skript ausgeführt, angeben, entweder ein file oder code Schlü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"});
});