EnglishBac à sable

Passer d'une alpha à l'autre

Pendant l'alpha, une API remplacée est retirée plutôt que gardée à côté de celle qui lui succède. Cette page liste ce qui est parti et ce qu'il faut écrire à la place. Les changesets de chaque version disent la même chose, paquet par paquet.

Stockage

Retiré À utiliser
storage de @fluixi/core useStorage() de @fluixi/core/storage, ou @fluixi/storage hors d'une application
createMemoryStorage de @fluixi/core memoryStorage() de @fluixi/storage

L'ancien storage était un objet à la forme de localStorage, et sur le serveur une Map partagée par toutes les requêtes. useStorage choisit le support selon l'endroit où le code s'exécute et garde les valeurs du serveur par requête. Voir Stockage dans une application.

Les valeurs écrites par @fluixi/session et par createTheme avant ce changement ne sont pas lues : les deux stockent désormais par @fluixi/storage, le thème dans un cookie. Un visiteur se reconnecte une fois et choisit de nouveau son thème.

Données en cache

Retiré À utiliser
createCachedResource(...), qui renvoyait [data, actions] cachedResource(...), une seule poignée avec refetch, invalidate et mutate
clearCachedResourceNamespace(name) clearCachedResources(name)
clearAllCachedResources() clearCachedResources()
// avant
const [orgs, { invalidate }] = createCachedResource(fetchOrgs, { name: 'orgs' });
// après
const orgs = cachedResource(fetchOrgs, { name: 'orgs' });
orgs.invalidate();

Les entrées vivent désormais par requête sur le serveur et par page dans le navigateur ; rien n'est partagé entre visiteurs. Le cache() du routeur se comporte de même, et revalidate recharge aussi les routes à l'écran. Voir Mise en cache des données.

Thèmes

createTheme garde par défaut le choix dans un cookie et envoie son script d'avant affichage avec la page pendant un rendu : retirez un script de thème écrit à la main dans index.html. Passez script: false pour garder le vôtre, et storage pour garder le choix ailleurs.

Dans fluixi-ui, ColorSchemeProvider est désormais celui du cœur : ses options sont ColorSchemeOptions (storageKey, attribute, storage, systemAs, themeColor), et schemes, default et system ont disparu. Pour un schéma avec plus de valeurs que clair et sombre, utilisez createTheme avec ThemeProvider. Voir Thèmes.

Rouages du serveur

streamDocument de @fluixi/start renvoie une promesse de Response au lieu de la Response : il attend la tête de la page avant de répondre, si bien que les en-têtes posés pendant le rendu de la coquille atteignent encore la réponse. Seule une entrée serveur personnalisée qui l'appelait directement a besoin d'un await.