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

• pulltorefresh active le contrôle d'actualisation natif.
• preventoverscroll doit être défini sur false — 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.