@capgo/inappbrowser
Capacitor-Plugin im App-Browser.
Übersicht
Abschnitt mit dem Titel “Übersicht”Capacitor-Plugin im App-Browser.
Kernfunktionen
Abschnitt mit dem Titel “Kernfunktionen”goBack- Gibt zurück in die WebView-Geschichte, wenn möglich.open- Öffnet die URL in einem neuen Fenster im Vollbildmodus, auf Android wird Chrome Custom Tabs verwendet, auf iOS wird SFSafariViewController verwendet.clearCookies- Löscht Cookies der URL Wennidgilt nicht angegeben, gilt für alle geöffneten WebViews.clearAllCookies- Löscht alle Cookies Wennidgilt nicht angegeben, gilt für alle geöffneten WebViews.
Öffentliche API
Abschnitt mit dem Titel „Öffentliche API“| Methode | Beschreibung |
|---|---|
goBack | Gibt zurück in die WebView-Geschichte, wenn möglich. |
open | Öffnet die URL in einem neuen Fenster im Vollbildmodus, auf Android wird Chrome Custom Tabs verwendet, auf iOS wird SFSafariViewController verwendet. |
clearCookies | Cookies von URL löschen Wenn id ist weggelassen, gilt für alle geöffneten Webviews. |
clearAllCookies | Alle Cookies löschen Wenn id ist weggelassen, gilt für alle geöffneten Webviews. |
clearCache | Cache löschen Wenn id ist weggelassen, gilt für alle geöffneten Webviews. |
getCookies | Cookies für eine bestimmte URL abrufen. |
close | Schließen Sie die Webview. Wenn id ist weggelassen, schließt die aktive Webview. |
hide | Verstecken Sie die Webview ohne sie zu schließen. Verwenden Sie show() um sie wieder zu öffnen. Wenn id ist weggelassen, zielt auf die aktive Webview. |
show | Zeigen Sie eine zuvor versteckte Webview. Wenn id wird übersprungen, zielt auf das aktive WebView. |
openWebView | Öffnet eine URL in einem neuen WebView mit Werkzeugleisten und erweiterten Funktionen, wie Zugriff auf die Kamera, Zugriff auf Dateien, Ereignis-Abhören, JavaScript-Injecting, bidirektionale Kommunikation usw. |
executeScript | Fügt JavaScript code in das Fenster des InAppBrowser ein. Wenn id wird übersprungen, wird in allen geöffneten WebViews ausgeführt. |
postMessage | Sendet ein Ereignis an das WebView (In-App-Browser). Hören Sie in der Seite mit window.addEventListener('messageFromNative', listenerFunc). Der detail Payload muss JSON-seriellierbar sein. Wenn id wird übersprungen, wird an alle geöffneten WebViews ausgestrahlt. |
takeScreenshot | Fängt das aktuelle WebView-Bildschirmfenster als PNG-Screenshot ein. Wenn id wird übersprungen, zielt auf das aktive WebView. |
setUrl | Setzt die URL des WebViews. Wenn id wird übersprungen, zielt auf das aktive WebView. |
addListener | Listen auf Änderungen der URL, nur für openWebView. |
addListener | Siehe die Quelldefinitionen für die aktuelle Verhaltensweise. |
addListener | Listen nur auf Schließen-Klick für openWebView. |
addListener | Wird ausgelöst, wenn der Benutzer auf den Bestätigungsbutton klickt, wenn ein Hinweis erforderlich ist, funktioniert mit openWebView shareDisclaimer und closeModal. |
addListener | Wird ausgelöst, wenn die WebView ein Ereignis an die App zurücksendet. Verwenden Sie window.mobileApp.postMessage(...) in der Seite und behalten Sie den Payload JSON-seriellierbar. |
addListener | Wird ausgelöst, sobald ein Screenshot vom Plugin API, dem native Screenshot-Button oder der injizierten JavaScript-Brücke aufgenommen wird. |
addListener | Wird ausgelöst, wenn die Seite geladen wird. |
addListener | Wird ausgelöst, wenn eine Seitenladefehler auftritt. |
addListener | Wird ausgelöst, nachdem native Download-Handling eine Datei lokal gespeichert hat. Aktivieren Sie dies mit handleDownloads: true wenn Sie die WebView öffnen. |
addListener | Wird ausgelöst, wenn native Download-Handling fehlschlägt. Aktivieren Sie dies mit handleDownloads: true Wenn Sie die Webansicht öffnen. |
addListener | Wird ausgelöst, wenn eine Seite ein Popup/Neues Fenster öffnet. Verwenden Sie die zurückgegebene Popup-ID mit executeScript, postMessage, show, hide, und close. |
addListener | Hören Sie auf Proxysitzungen an, die durch den nativen Runtime delegiert werden. Vorzugsweise addProxyHandler() anstatt dies direkt aufzurufen. |
addListener | Hören Sie auf JavaScript-Konsolenausgaben an, die von der verwalteten Seite ausgestoßen werden. Aktivieren Sie dies mit captureConsoleLogs: true Wenn Sie die Webansicht öffnen. |
handleProxyRequest | Interne Methode, die von addProxyHandler() wird verwendet, um einen Proxyentscheid an die native Seite zurückzusenden. Führen Sie die ursprüngliche phase Wenn Sie auf eine manuelle proxyRequest Hinweis. |
removeAllListeners | Entfernen Sie alle Listener für diesen Plugin. |
reload | Laden Sie die aktuelle Webseite neu. |
updateDimensions | Aktualisiert die Abmessungen des Webviews. Er ermöglicht es, die Größe und Position des Webviews während der Laufzeit zu ändern. Wenn id weiterhin weggelassen wird, wird der aktive Webview angegangen. |
setEnabledSafeTopMargin | Setzt die aktivierbare sichere obere Randmarke des Webviews während der Laufzeit. Wenn id weiterhin weggelassen wird, wird der aktive Webview angegangen. Auf Web ist diese Methode ein No-Op und löst ohne Änderung der Layout ohne Änderung auf. |
setEnabledSafeBottomMargin | Setzt die aktivierbare sichere untere Randmarke des Webviews während der Laufzeit. Wenn id weiterhin weggelassen wird, wird der aktive Webview angegangen. Auf Web ist diese Methode ein No-Op und löst ohne Änderung der Layout ohne Änderung auf. |
openSecureWindow | Öffnet ein sicheres OAuth2-Fenster. Auf Web gibt es die umgeleitete URL durch einen BroadcastChannel; auf Mobilgeräten registriert ein benutzerdefiniertes Redirect-URI in Ihrer App-Konfiguration. Siehe die Anleitung zum Starten für die vollständige HTML, Info.plist und AndroidManifest Beispiele. |
Quelle der Wahrheit
Abschnitt mit dem Titel “Quelle der Wahrheit”Diese Referenz wird von der Quelle synchronisiert. src/definitions.ts in capacitor-InAppBrowser.