API de lecture/écriture de valeur
Stockez durablement une valeur de chaîne sur l'appareil et relisez-la dans le JavaScript de votre application web.
L'API de lecture/écriture de valeur stocke de manière persistante une chaîne arbitraire sur l'appareil (dans le stockage privé de l'application) et la relit dans votre JavaScript. Les valeurs survivent aux redémarrages de l'application et aux vidages de cache — tant que l'application n'est pas désinstallée.
Écrire une valeur :
Tout ce qui suit writevalue:// est stocké tel quel sous forme d'une seule chaîne. Définissez votre propre format (query-string, JSON, CSV — ce qui convient à votre application web) :
<a href="writevalue://darkmode=on;user=42">Enregistrer</a>
Lire une valeur :
Lorsque readvalue:// est déclenché, l'application réinjecte la chaîne stockée dans la WebView sous la forme de window.storedValues afin que votre JavaScript puisse la lire :
<a href="readvalue://" onclick="setTimeout(showSettings, 200)">Charger</a>
<script>
function showSettings() {
console.log(window.storedValues || "aucun réglage pour le moment");
}
</script>
Cas d'utilisation typiques :
- Mémoriser hors ligne le thème, la langue ou l'état d'onboarding d'un utilisateur.
- Mettre en cache un jeton de session lorsque vous ne pouvez pas compter sur les cookies.
- Conserver une petite préférence locale sans aller-retour avec le backend.
Remarques : les valeurs sont propres à chaque installation de l'application et à chaque appareil — elles ne sont pas synchronisées entre appareils. Gardez des valeurs de petite taille ; cette API est destinée aux réglages, pas au stockage de blobs.
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.