Copy page

Notes de mise à niveau

Cette page liste les changements de form0 qui demandent une action de votre part. Si une version n’y figure pas, vous pouvez l’installer sans modifier votre code. Pour les nouvelles fonctionnalités et les corrections, consultez les notes de version de form0-core, form0-react, form0-react-native et form0-cli.

Les changements sont classés du plus récent au plus ancien. Pour mettre à niveau, traitez toutes les entrées plus récentes que les versions que vous utilisez aujourd’hui.

Trouvez les changements qui vous concernent

Comparez les versions que vous utilisez avec chaque ligne. Une ligne vous concerne si votre version est antérieure à celle indiquée. La date est celle de la publication du premier paquet contenant le changement. Un paquet absent de la ligne n’est pas concerné.

Date	Changement	Versions
2026-10-31	Les lignes vides enregistrées restent dans l’enregistrement	core 0.11.0, react 0.10.0, react-native 0.11.0, cli 0.10.0
2026-10-30	Les valeurs des champs sont vérifiées par type	core 0.10.0, react 0.9.0, react-native 0.10.0, cli 0.10.0
2026-10-30	Les schémas qui effacent les valeurs masquées exigent que tous les paquets soient à jour	core 0.10.0, react 0.9.0, react-native 0.10.0, cli 0.10.0
2026-10-29	Les champs de choix exigent des identifiants textuels dans SETVALUE()	core 0.9.0, react 0.6.0, react-native 0.7.0, cli 0.9.0
2026-10-28	FormRenderer exige recordKind	react 0.5.0, react-native 0.6.0
2026-10-27	Les gestionnaires ne peuvent pas modifier un enregistrement en lecture seule	core 0.8.0, react 0.5.0, react-native 0.6.0, cli 0.8.0
2026-10-22	Les conditions ne peuvent lire que leur propre enregistrement et ses parents	core 0.6.0
2026-10-08	Les éditeurs de ligne sur mobile n’exécutent plus les événements d’enregistrement	react-native 0.3.0

Mettez à niveau les paquets ensemble

Chaque binding dépend d’une version correspondante de form0-core : installez-les en même temps :

• React: npm install form0-react@latest form0-core@latest
• React Native: npm install form0-react-native@latest form0-core@latest
• CLI: npm install --global form0-cli@latest

Les lignes vides enregistrées restent dans l’enregistrement

Publié : 2026-10-31

S’applique à partir de : form0-core 0.11.0, form0-react 0.10.0, form0-react-native 0.11.0, form0-cli 0.10.0

Agissez si une section répétable n’a que des champs facultatifs et que votre serveur ou votre base de données attend une réponse dans chaque ligne. Un utilisateur peut ajouter une ligne et l’enregistrer sans rien saisir. Cette ligne était auparavant retirée de l’enregistrement soumis. Elle y reste désormais, avec son identifiant, ses horodatages et des réponses null.

Que faire : Marquez un champ de la ligne comme required pour qu’elle ne puisse pas être enregistrée vide, ou gérez ces lignes sur votre serveur. Lignes vides enregistrées montre le résultat.

Vérifiez : Ouvrez le formulaire, ajoutez une ligne et enregistrez-la sans rien saisir. Cliquez sur Submit et confirmez que votre serveur accepte l’enregistrement.

Les valeurs des champs sont vérifiées par type

Publié : 2026-10-30

S’applique à partir de : form0-core 0.10.0, form0-react 0.9.0, form0-react-native 0.10.0, form0-cli 0.10.0

Agissez si votre application ou vos enregistrements stockés contiennent des valeurs qui ne correspondent pas au type du champ. form0 ne les convertit pas : un champ visible avec l’une de ces valeurs affiche donc une erreur et bloque Submit :

Champ	Désormais une erreur	À utiliser
NumericField	"12"	12
TextField	42	"42"
DateField	2026-02-30, not-a-date	Une vraie date au format YYYY-MM-DD
TimeField	24:00	HH:MM ou HH:MM:SS

Que faire : Convertissez les valeurs avant de les passer à initialValues, initialSnapshot, overrideValues ou SETVALUE(), et corrigez les enregistrements stockés qui les contiennent. Un serveur qui appelle prepareSubmission() rejette aussi ces valeurs.

Vérifiez : Enregistrez un échantillon de vos valeurs sous le nom values.json et exécutez cette commande. Tout problème apparaît dans errors dans la sortie :

Code
form0 run path/to/schema.json --values values.json

Les schémas qui effacent les valeurs masquées exigent que tous les paquets soient à jour

Publié : 2026-10-30

S’applique à partir de : form0-core 0.10.0, form0-react 0.9.0, form0-react-native 0.10.0, form0-cli 0.10.0

Agissez si vous ajoutez visible_preserve_value à un schéma. Les paquets plus anciens rejettent l’attribut avec cette erreur :

Code
Field "email" (TextField) does not support visible_preserve_value attribute

Que faire : Mettez à niveau tous les paquets qui lisent le schéma avant d’ajouter l’attribut, y compris form0-core sur votre serveur et form0-cli sur votre machine.

Vérifiez : Exécutez cette commande. Elle se termine avec le statut 0 :

Code
form0 validate path/to/schema.json

Les champs de choix exigent des identifiants textuels dans SETVALUE()

Publié : 2026-10-29

S’applique à partir de : form0-core 0.9.0, form0-react 0.6.0, form0-react-native 0.7.0, form0-cli 0.9.0

Agissez si un gestionnaire passe à SETVALUE() une valeur de choix sous forme de nombre, de booléen ou avec une forme incorrecte.

Que faire : SingleChoiceField et BooleanField acceptent un identifiant textuel. MultiChoiceField accepte un tableau d’identifiants textuels.

Code
// Before: these leave the field unchanged
SETVALUE("rating", 1)
SETVALUE("tags", "red")

// Now
SETVALUE("rating", "1")
SETVALUE("tags", ["red"])

Un gestionnaire qui écrit dans un champ inaccessible, comme un champ d’une ligne de section répétable depuis un gestionnaire du formulaire principal, perd désormais tous ses appels à SETVALUE(), pas seulement celui-ci.

Vérifiez : Recherchez SETVALUE( dans vos schémas, déclenchez chaque gestionnaire et vérifiez que le champ affiche la valeur. Des versions antérieures de form0-react peuvent laisser le champ inchangé sans message console en mode géré. Les bindings avec eventDiagnostics signalent ces échecs par défaut ; vérifiez aussi le formulaire lui-même.

FormRenderer exige recordKind

Publié : 2026-10-28

S’applique à partir de : form0-react 0.5.0, form0-react-native 0.6.0

Agissez si vous utilisez FormRenderer de form0-react ou form0-react-native. Sans recordKind, il lève cette erreur :

Code
form0: events.recordKind must be "new" or "existing" when lifecycle is enabled.

Que faire : Réglez recordKind sur "new" pour un nouvel enregistrement, ou sur "existing" à l’ouverture d’un enregistrement sauvegardé :

Code
<FormRenderer engineOptions={{ events: { recordKind: "new" } }} schema={schema} />

Les événements du cycle de vie et les événements de focus et de perte de focus des champs sont désormais actifs par défaut : leurs gestionnaires commencent donc à s’exécuter. Les contrôles intégrés n’émettent pas click automatiquement. Pour conserver le comportement précédent, désactivez ces événements :

Code
<FormRenderer
  engineOptions={{ events: { lifecycle: false, fieldInteractions: [] } }}
  schema={schema}
/>

Vérifiez : Ouvrez le formulaire et vérifiez qu’il s’affiche sans l’erreur. Si vous utilisez des gestionnaires du cycle de vie, vérifiez que chacun s’exécute une seule fois.

Les gestionnaires ne peuvent pas modifier un enregistrement en lecture seule

Publié : 2026-10-27

S’applique à partir de : form0-core 0.8.0, form0-react 0.5.0, form0-react-native 0.6.0, form0-cli 0.8.0

Agissez si un gestionnaire de load-record appelle SETVALUE() et le formulaire peut s’ouvrir en lecture seule. load-record s’exécute dans les deux modes.

Que faire : Déplacez l’écriture vers new-record ou edit-record :

Code
// Before: rejected when the form opens read-only
ON("load-record", function () {
  SETVALUE("status_note", "Opened")
})

// Now: runs only when the user is editing
ON("edit-record", function () {
  SETVALUE("status_note", "Opened")
})

Vous pouvez aussi conserver le gestionnaire et tester event.mode :

Code
ON("load-record", function (event) {
  if (event.mode === "edit") SETVALUE("status_note", "Opened")
})

Vérifiez : Ouvrez le formulaire avec mode="readonly". Si un gestionnaire écrit encore, la console affiche ce message et le formulaire s’ouvre sans les modifications de ce gestionnaire : View-mode handlers cannot change record data.

Les conditions ne peuvent lire que leur propre enregistrement et ses parents

Publié : 2026-10-22

S’applique à partir de : form0-core 0.6.0

Agissez si votre schéma comporte des sections répétables et une condition lit un champ de ligne depuis l’extérieur de cette ligne. form0-core rejette le schéma avec une erreur comme celle-ci :

Code
Field "note" visible_conditions references "amount" outside its record scope (owner: main form; reference: payments)

Que faire : Faites pointer la condition vers un champ de la même ligne, d’une ligne parente ou du formulaire principal. Portées parent et enfant contient un exemple complet.

Vérifiez : Exécutez cette commande pour chaque schéma. Elle se termine avec le statut 1 et affiche l’erreur si une condition est hors de portée :

Code
form0 validate path/to/schema.json

Les éditeurs de ligne sur mobile n’exécutent plus les événements d’enregistrement

Publié : 2026-10-08

S’applique à partir de : form0-react-native 0.3.0

Agissez si vous effectuez la mise à niveau depuis form0-react-native 0.2.x et un gestionnaire compte sur l’exécution de load-record, edit-record ou change dans une ligne répétable.

Que faire : Déplacez la logique de ligne vers les événements répétables, avec le data_name de votre section répétable :

Code
ON("load-repeatable", "rows", function () {
  // Runs when a row opens
})

ON("new-repeatable", "rows", function () {
  // Runs when a new row starts editing
})

ON("edit-repeatable", "rows", function () {
  // Runs when an existing row starts editing
})

Vérifiez : Ouvrez une ligne et vérifiez que votre gestionnaire s’exécute. Les gestionnaires du formulaire principal ne s’exécutent plus à l’ouverture d’une ligne.