API Pull-to-Refresh
Active el gesto nativo de deslizar para actualizar en su app WebView de iOS, personalice sus colores y actívelo o desactívelo dinámicamente desde su app web.
La API Pull-to-Refresh añade el gesto nativo de iOS «deslizar para actualizar» a su app WebView: los usuarios arrastran la página hacia abajo para recargar la URL actual, igual que en apps nativas como Mail o Safari.
Cómo activarlo:
Abra Config.swift y establezca:
var pulltorefresh = true var preventoverscroll = false
pulltorefreshactiva el control de actualización nativo.preventoverscrolldebe estar enfalse: el gesto necesita la animación de rebote (overscroll) del WebView para funcionar.
Personalizar los colores:
Puede dar estilo al indicador de carga y a su fondo por separado para el modo claro y el modo oscuro en Config.swift:
var pulltorefresh_loadingsigncolour_lightmode = #colorLiteral(...) var pulltorefresh_backgroundcolour_lightmode = #colorLiteral(...) var pulltorefresh_loadingsigncolour_darkmode = #colorLiteral(...) var pulltorefresh_backgroundcolour_darkmode = #colorLiteral(...)
Consejo: haga clic en la muestra de color junto a cada #colorLiteral en Xcode para elegir un color visualmente. Las variantes del modo oscuro requieren iOS 13 o superior.
Alternar dinámicamente desde su app web:
Puede activar o desactivar el pull-to-refresh en tiempo de ejecución, por ejemplo, para desactivarlo en páginas con sus propios gestos de deslizamiento (mapas, sliders, juegos):
<a href="enablepulltorefresh://">Activar pull-to-refresh</a> <a href="disablepulltorefresh://">Desactivar pull-to-refresh</a>
O mediante JavaScript:
window.location.href = "disablepulltorefresh://";
Ambos comandos también se admiten dentro de una solicitud MultiAPICall.
Conviene saber:
- El control de actualización recarga la URL que se muestra actualmente en el WebView.
- Si utiliza la API Dynamic UI para cambiar el color de la barra inferior en tiempo de ejecución, los colores del pull-to-refresh se ajustan automáticamente para coincidir.
Notas de implementación estilo SDK
Trate esta función como una capacidad nativa expuesta a su capa web: mantenga su sitio web de producción o PWA como fuente de verdad y, a continuación, utilice los indicadores de configuración de WebViewGold, los comandos de URL y las llamadas del puente de JavaScript documentados para activar el comportamiento nativo de iOS solo donde aporte valor. Este enfoque mantiene su código fácil de mantener, porque la misma aplicación web puede servir a los navegadores, a WebViewGold para iOS y a las demás plataformas de WebViewGold con una lógica condicional mínima.
Para obtener resultados fiables, opte por puntos de conexión HTTPS, nombres de ruta estables, estados de éxito/error explícitos en su interfaz y pequeñas funciones auxiliares de JavaScript que envuelvan las llamadas nativas. Por ejemplo, una aplicación web creada con jQuery Mobile, Lovable, Base44, Bolt, WordPress, Bubble, una pila propia de React/Vue/Angular o HTML estático puede exponer un único botón o controlador de eventos que active la API nativa de WebViewGold y, aun así, muestre una alternativa elegante en el navegador.
- Patrón de integración recomendado: detecte el contexto de la app, llame a la API de WebViewGold y luego actualice su interfaz web tras la devolución de llamada nativa o el cambio de ruta.
- Lista de comprobación de pruebas: valide la función en un dispositivo real o en una compilación empaquetada, verifique los permisos y el texto de revisión de la tienda, y confirme que los usuarios que solo usan el navegador siguen recibiendo una alternativa útil.
- Ventaja para el SEO: mantenga las páginas de funciones, los títulos de ruta y el contenido estructurado indexables en su sitio web, mientras WebViewGold ofrece la carcasa nativa de la app para los usuarios de iOS.