This repository has been archived on 2023-02-21. You can view files and clone it, but cannot push or open issues or pull requests.
momo/plugins/org.apache.cordova.inappbro.../doc/de/index.md

13 KiB

org.apache.cordova.inappbrowser

Dieses Plugin bietet eine Web-Browser-Ansicht, die beim Aufruf angezeigtwindow.open().

var ref = window.open('http://apache.org', '_blank', 'location=yes');

Hinweis: Das InAppBrowser Fenster verhält sich wie ein Standard-Webbrowser. Auf die Cordova-API kann in diesem Moment nicht zugegriffen werden!

Installation

cordova plugin add org.apache.cordova.inappbrowser

window.open

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

var ref = window.open(url, target, options);
  • Ref: Bezugnahme auf das InAppBrowser Fenster. (InAppBrowser)

  • URL: die URL um den (String) zu laden. Rufen Sie encodeURI() auf, wenn die URL Unicode-Zeichen enthält.

  • Ziel: das Ziel in welchem die URL geladen werden soll. Standardmäßig entspricht dieser Wert _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.

    Nur Windows:

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

Unterstützte Plattformen

  • Amazon Fire OS
  • Android
  • BlackBerry 10
  • Firefox OS
  • iOS
  • Windows 8 und 8.1
  • 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 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 8 und 8.1
  • Windows Phone 7 und 8

Kurzes 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 8 und 8.1
  • Windows Phone 7 und 8

Kurzes 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
  • Firefox OS
  • iOS
  • Windows 8 und 8.1
  • Windows Phone 7 und 8

Kurzes 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
  • Windows 8 und 8.1

Kurzes 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
  • Windows 8 und 8.1

Kurzes 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

Kurzes Beispiel

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