@capgo/capacitor-navigateur-intérieur

Aperçu

@capgo/capacitor-inappbrowser gives Capacitor apps two browser paths: open() pour l'expérience de navigateur système et openWebView() for a managed native WebView that your app can size, hide, message, script, proxy, and layer with Ionic UI.

Utilisez-le lorsque la page nécessite plus qu'un simple navigateur externe : flux OAuth et de paiement, portails de support intégrés, écrans de paiement, appels vidéo, portails de documents, applications web interactives ou tout flux où votre application a besoin de contrôles natifs autour de contenu web en direct.

Le nom du package a changé.

Utilisations courantes

• Afficher l'interface Ionic ou Capacitor au-dessus d'une page de navigateur en direct toBack, sendToBack(), bringToFront(), transparentBackground, et dispatchInputEvent().
• Construirez des navigateurs d'écran partiel, des feuilles de bas de page et des vues web en image en pièce avec width, height, x, y, et updateDimensions().
• Let users tap the Capacitor app outside a custom-size browser frame on Android and iOS.
• Utilisez les flux de paiement, de connexion, de support ou de basculement de compte sans stockage de site web persistant. persistWebViewData: false et clearAllBrowsingData().
• Maintenez plusieurs instances de navigateur chargées avec hidden, hide()et show() en préservant l'état de la page.
• Embed advanced web apps that need request proxying, file uploads, downloads, popup control, Google Pay support, _blank la gestion des liens et le messaging application-page.

Capacités de base

• open - Ouvre une URL dans les onglets personnalisés de Chrome sur Android ou SFSafariViewController sur iOS.
• openWebView Ouvre une fenêtre native gérée avec une barre d'outils personnalisée, une taille personnalisée, une navigation native, des messages, des scripts, un proxy, des téléchargements, des pop-ups et des contrôles de données.
• sendToBack / bringToFront Déplace un navigateur géré derrière ou au-dessus de la Capacitor vue d'application hôte.
• dispatchInputEvent - Modifie la taille et la position de la vue gérée sans recharger la page.
• updateDimensions - Ouvre une URL dans les onglets personnalisés de Chrome sur Android ou sur iOS.
• hide / show - Garde les WebViews gérés chargés tout en supprimant ou en rétablissant leur présentation native.
• postMessage / executeScript - Connecte l'application Capacitor avec le JavaScript exécuté à l'intérieur de la page gérée.
• clearAllBrowsingData / persistWebViewData Contrôle des cookies, cache, stockage, IndexedDB et persistance de session.
• handleDownloadsSupporte les portails de documentation, les flux d'upload, les pages de paiement et les applications web intégrées.

- Public API

- Méthode	- Description
goBack	- Retourne en arrière dans l'historique de la WebView si possible.
open	Ouvrir l'URL dans une nouvelle fenêtre plein écran, sur Android, il utilise les onglets personnalisés Chrome, sur iOS, il utilise SFSafariViewController.
clearCookies	- Efface les cookies de l'URL Lorsque id - Si omis, s'applique à toutes les webviews ouvertes.
clearAllCookies	Effacer toutes les cookies Lorsque id is omitted, applies to all open webviews.
clearCache	Effacer le cache Lorsque id is omitted, applies to all open webviews.
clearAllBrowsingData	Efface les cookies, le cache, le stockage local, le stockage de session, IndexedDB et autres données de navigation du magasin par défaut et des WebViews gérés.
getCookies	Obtenir les cookies pour une URL spécifique.
close	Fermer le webview. Lorsque id ce paramètre est omis, ferme le webview actif.
hide	Cacher le webview sans le fermer. Utilisez show() pour le faire réapparaître. Lorsque id ce paramètre est omis, cible le webview actif.
show	Afficher un webview précédemment caché. Lorsque id ce paramètre est omis, cible le webview actif.
sendToBack	Déplace le navigateur natif derrière la Capacitor Vue de l'hôte pour afficher l'interface utilisateur de l'application au-dessus.
bringToFront	Déplace un navigateur qui se trouvait derrière le WebView hôte vers l'avant.
dispatchInputEvent	Envoie les événements de clic, de toucher ou de scroll vers un navigateur géré ; les coordonnées sont relatives à la vue de navigateur.
openWebView	Ouvrez l'URL dans une nouvelle vue web avec des barres d'outils et des capacités améliorées, comme l'accès à la caméra, l'accès aux fichiers, l'écoute d'événements, l'injection de JavaScript, la communication bidirectionnelle, etc.
executeScript	Injecte le JavaScript code dans la fenêtre InAppBrowser. Lorsque id est omis, il s'exécute dans toutes les fenêtres web ouvertes.
postMessage	Envoie un événement vers la fenêtre de navigateur (navigateur intégré). Écoutez dans la page avec window.addEventListener('messageFromNative', listenerFunc)Le detail doit être sérialisable en JSON. Lorsque id is omitted, broadcasts to all open webviews.
takeScreenshot	Captures l'écran actuel de la vue webview sous forme d'image PNG. Lorsque id est omis, il cible la fenêtre de navigateur active.
setUrl	Définit l'URL de la vue web. Lorsque id est omis, cible la vue web active.
addListener	Ecoutez les changements d'URL, uniquement pour openWebView.
addListener	Ecoutez les buttonNearDoneClick ; le payload contient la vue web id.
addListener	Ecoutez uniquement le clic de fermeture pour openWebView.
addListener	Sera déclenché lorsque l'utilisateur clique sur le bouton de confirmation lorsqu'un avertissement est requis, fonctionne avec openWebView shareDisclaimer et closeModal.
addListener	Sera déclenché lorsque la vue web envoie un événement vers l'application. Utilisez window.mobileApp.postMessage(...) dans la page, et gardez le payload JSON-serialisable.
addListener	Serait déclenché chaque fois qu'un écran d'écriture est capturé à partir du plugin API, le bouton d'écran natif ou le pont JavaScript injecté.
addListener	Sera déclenché lorsque la page est chargée.
addListener	Se déclenchera lors d'une erreur de chargement de page.
addListener	Sera déclenché après que le traitement local du téléchargement natif a enregistré un fichier localement. Activez-l’avec handleDownloads: true lorsque vous ouvrez la vue web.
addListener	Sera déclenché lorsque le traitement local du téléchargement natif échoue. Activez-l’avec handleDownloads: true lorsque vous ouvrez la vue web.
addListener	Sera déclenché chaque fois qu'une page ouvre une nouvelle fenêtre popup. Utilisez l'ID de popup retourné avec executeScript, postMessage, show, hideet close.
addListener	Écoutez les requêtes proxy déléguées par le runtime natif. Préférez addProxyHandler() au lieu d'appeler cela directement.
addListener	Écoutez les sorties de la console JavaScript émises par la page gérée. Activez-l’avec captureConsoleLogs: true lorsque vous ouvrez la vue web.
handleProxyRequest	Méthode interne utilisée par addProxyHandler() pour renvoyer une décision de proxy vers le natif. Transmettez l'original phase lorsque vous répondez à un manuel proxyRequest l'écouteur.
removeAllListeners	Supprimez tous les écouteurs pour ce plugin.
reload	Rechargez la page web actuelle.
updateDimensions	Mettez à jour les dimensions de la vue web. Permet de modifier la taille et la position de la vue web en temps réel. id est omis, cible la vue web active.
setEnabledSafeTopMargin	Définit la marge de sécurité supérieure autorisée du webview en temps de exécution. Lorsque id est omis, cible la vue web active. Sur le Web, cette méthode est un no-op et se résout sans modifier la disposition.
setEnabledSafeBottomMargin	Fixe la marge inférieure en sécurité de la vue web en temps de exécution. Lorsque id est omis, cible la vue web active. Sur le Web, cette méthode est un no-op et se résout sans modifier la disposition.
openSecureWindow	ouvre une fenêtre OAuth2 sécurisée. Sur le Web, renvoie l'URL redirigée à travers un BroadcastChannelEnregistrez un URI de redirection personnalisé dans la configuration de votre application sur mobile. Consultez le guide de démarrage pour les exemples complets d'HTML, Info.plist et AndroidManifest.

Valeurs de Référence

Utilisez ces valeurs avec les options de la barre d'outils lors de l'ouverture d'un navigateur intégré ou d'une vue Web.

Types de Barres d'Outils

Valeur	Les utilisateurs trouveront
activity	Barre d'outils simple avec contrôles de fermeture et de partage.
compact	Barre d'outils simple avec un contrôle de fermeture.
navigation	Barre de navigation complète avec contrôles de retour et d'avance.
blank	No toolbar.

Source de Vérité

Cette référence est synchronisée à partir de src/definitions.ts dans capacitor-inappbrowser.

Continuez à partir de @capgo/capacitor-inappbrowser

Si vous utilisez @capgo/capacitor-navigateur-intérieur pour planifier le travail de plugin natif, connectez-l’avec En utilisant @capgo/capacitor-inappbrowser pour la capacité native dans En utilisant @capgo/capacitor-inappbrowser, Capgo Répertoire des plugins pour le flux de travail du produit dans le Répertoire du Plugin Capgo Capacitor Plugins par Capgo pour le détail d'implémentation dans Capacitor Plugins par Capgo Ajouter ou mettre à jour des plugins pour le détail d'implémentation dans Ajouter ou mettre à jour des plugins, et Alternatives de plugins Ionic Enterprise pour le flux de travail du produit dans Alternatives de plugins Ionic Enterprise.