API Pull-to-Refresh
Activez le geste natif « tirer pour actualiser » dans votre app WebView iOS, personnalisez ses couleurs et basculez-le dynamiquement depuis votre app web.
L'API Pull-to-Refresh ajoute le geste natif iOS « tirer pour actualiser » à votre app WebView : les utilisateurs tirent la page vers le bas pour recharger l'URL actuelle — exactement comme dans les apps natives telles que Mail ou Safari.
Activation :
Ouvrez Config.swift et définissez :
var pulltorefresh = true var preventoverscroll = false
pulltorefreshactive le contrôle d'actualisation natif.preventoverscrolldoit être défini surfalse— le geste a besoin de l'animation de rebond (overscroll) de la WebView pour fonctionner.
Personnaliser les couleurs :
Vous pouvez styliser l'indicateur de chargement et son arrière-plan séparément pour les modes clair et sombre dans Config.swift :
var pulltorefresh_loadingsigncolour_lightmode = #colorLiteral(...) var pulltorefresh_backgroundcolour_lightmode = #colorLiteral(...) var pulltorefresh_loadingsigncolour_darkmode = #colorLiteral(...) var pulltorefresh_backgroundcolour_darkmode = #colorLiteral(...)
Astuce : cliquez sur la pastille de couleur à côté de chaque #colorLiteral dans Xcode pour choisir une couleur visuellement. Les variantes du mode sombre nécessitent iOS 13 ou une version ultérieure.
Basculer dynamiquement depuis votre app web :
Vous pouvez activer ou désactiver le pull-to-refresh à l'exécution — par exemple pour le désactiver sur des pages avec leurs propres gestes de balayage (cartes, sliders, jeux) :
<a href="enablepulltorefresh://">Activer le pull-to-refresh</a> <a href="disablepulltorefresh://">Désactiver le pull-to-refresh</a>
Ou via JavaScript :
window.location.href = "disablepulltorefresh://";
Les deux commandes sont également prises en charge dans une requête MultiAPICall.
Bon à savoir :
- Le contrôle d'actualisation recharge l'URL actuellement affichée dans la WebView.
- Si vous utilisez l'API Dynamic UI pour changer la couleur de la barre inférieure à l'exécution, les couleurs du pull-to-refresh sont ajustées automatiquement pour correspondre.
Notes d’implémentation façon SDK
Considérez cette fonctionnalité comme une capacité native exposée à votre couche web : conservez votre site web de production ou votre PWA comme source de vérité, puis utilisez les indicateurs de configuration WebViewGold documentés, les commandes URL et les appels du pont JavaScript pour activer le comportement natif iOS uniquement là où il apporte de la valeur. Cette approche garde votre base de code maintenable, car la même application web peut servir les navigateurs, WebViewGold pour iOS et les autres plateformes WebViewGold avec un minimum de logique conditionnelle.
Pour des résultats fiables, privilégiez les points de terminaison HTTPS, des noms de routes stables, des états de succès/erreur explicites dans votre interface et de petites fonctions JavaScript qui encapsulent les appels natifs. Par exemple, une application web créée avec jQuery Mobile, Lovable, Base44, Bolt, WordPress, Bubble, une pile React/Vue/Angular personnalisée ou du HTML statique peut exposer un seul bouton ou gestionnaire d’événement qui déclenche l’API native WebViewGold tout en affichant une solution de repli élégante dans le navigateur.
- Modèle d’intégration recommandé : détectez le contexte de l’application, appelez l’API WebViewGold, puis mettez à jour votre interface web après le rappel natif ou le changement de route.
- Liste de vérification des tests : validez la fonctionnalité sur un appareil réel ou une build empaquetée, vérifiez les autorisations et le texte de revue du store, et confirmez que les utilisateurs navigateur uniquement reçoivent toujours une solution de repli utile.
- Avantage SEO : gardez les pages de fonctionnalités, les titres de routes et le contenu structuré indexables sur votre site web pendant que WebViewGold fournit l’enveloppe d’application native pour les utilisateurs iOS.