Copy page

Notas de actualización

Esta página enumera los cambios de form0 que requieren alguna acción por tu parte. Si una versión no aparece aquí, puedes instalarla sin cambiar tu código. Para ver funciones nuevas y correcciones, consulta las notas de versión de form0-core, form0-react, form0-react-native y form0-cli.

Los cambios aparecen del más reciente al más antiguo. Para actualizar, revisa todas las entradas posteriores a las versiones que usas hoy.

Encuentra los cambios que te afectan

Compara las versiones que usas con cada fila. Una fila te afecta si tu versión es anterior a la indicada. La fecha es la de publicación del primer paquete con el cambio. Un paquete que no aparece no se ve afectado.

Fecha	Cambio	Versiones
2026-10-31	Las filas vacías guardadas permanecen en el registro	core 0.11.0, react 0.10.0, react-native 0.11.0, cli 0.10.0
2026-10-30	Los valores de los campos se comprueban por tipo	core 0.10.0, react 0.9.0, react-native 0.10.0, cli 0.10.0
2026-10-30	Los esquemas que borran valores ocultos necesitan todos los paquetes actualizados	core 0.10.0, react 0.9.0, react-native 0.10.0, cli 0.10.0
2026-10-29	Los campos de selección necesitan identificadores de texto en SETVALUE()	core 0.9.0, react 0.6.0, react-native 0.7.0, cli 0.9.0
2026-10-28	FormRenderer requiere recordKind	react 0.5.0, react-native 0.6.0
2026-10-27	Los manejadores no pueden cambiar un registro de solo lectura	core 0.8.0, react 0.5.0, react-native 0.6.0, cli 0.8.0
2026-10-22	Las condiciones solo pueden leer su propio registro y sus padres	core 0.6.0
2026-10-08	Los editores de fila en móvil ya no ejecutan eventos de registro	react-native 0.3.0

Actualiza los paquetes a la vez

Cada binding depende de una versión concreta de form0-core, así que instálalos al mismo tiempo:

• 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

Las filas vacías guardadas permanecen en el registro

Publicado: 2026-10-31

Se aplica desde: form0-core 0.11.0, form0-react 0.10.0, form0-react-native 0.11.0, form0-cli 0.10.0

Actúa si una sección repetible solo tiene campos opcionales y tu servidor o tu base de datos esperan que cada fila tenga alguna respuesta. Un usuario puede añadir una fila y guardarla sin escribir nada. Antes esa fila se quitaba del registro enviado. Ahora permanece, con su identificador, sus marcas de tiempo y respuestas null.

Qué hacer: Marca un campo de la fila como required para que no se pueda guardar vacía, o gestiona estas filas en tu servidor. Filas vacías guardadas muestra el resultado.

Compruébalo: Abre el formulario, añade una fila y guárdala sin escribir nada. Haz clic en Submit y confirma que tu servidor acepta el registro.

Los valores de los campos se comprueban por tipo

Publicado: 2026-10-30

Se aplica desde: form0-core 0.10.0, form0-react 0.9.0, form0-react-native 0.10.0, form0-cli 0.10.0

Actúa si tu aplicación o tus registros guardados contienen valores que no coinciden con el tipo del campo. form0 no los convierte, así que un campo visible con uno de estos valores muestra un error y bloquea Submit:

Campo	Ahora es un error	Usa en su lugar
NumericField	"12"	12
TextField	42	"42"
DateField	2026-02-30, not-a-date	Una fecha real como YYYY-MM-DD
TimeField	24:00	HH:MM o HH:MM:SS

Qué hacer: Convierte los valores antes de pasarlos a initialValues, initialSnapshot, overrideValues o SETVALUE(), y corrige los registros guardados que los contengan. Un servidor que llama a prepareSubmission() también rechaza estos valores.

Compruébalo: Guarda una muestra de tus valores como values.json y ejecuta este comando. Cualquier problema aparece en errors en la salida:

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

Los esquemas que borran valores ocultos necesitan todos los paquetes actualizados

Publicado: 2026-10-30

Se aplica desde: form0-core 0.10.0, form0-react 0.9.0, form0-react-native 0.10.0, form0-cli 0.10.0

Actúa si añades visible_preserve_value a un esquema. Los paquetes anteriores rechazan el atributo con este error:

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

Qué hacer: Actualiza todos los paquetes que leen el esquema antes de añadir el atributo, incluidos form0-core en tu servidor y form0-cli en tu equipo.

Compruébalo: Ejecuta este comando. Termina con estado 0:

Code
form0 validate path/to/schema.json

Los campos de selección necesitan identificadores de texto en SETVALUE()

Publicado: 2026-10-29

Se aplica desde: form0-core 0.9.0, form0-react 0.6.0, form0-react-native 0.7.0, form0-cli 0.9.0

Actúa si un manejador pasa a SETVALUE() un valor de selección como número, como booleano o con una forma incorrecta.

Qué hacer: SingleChoiceField y BooleanField aceptan un identificador de texto. MultiChoiceField acepta un array de identificadores de texto.

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

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

Un manejador que escribe en un campo al que no puede acceder, como un campo de una fila de una sección repetible desde un manejador del formulario principal, ahora pierde todas sus llamadas a SETVALUE(), no solo esa.

Compruébalo: Busca SETVALUE( en tus esquemas, ejecuta cada manejador y confirma que el campo muestra el valor. Versiones anteriores de form0-react pueden dejar el campo sin cambios y sin mensaje de consola en modo gestionado. Los bindings con eventDiagnostics informan de estos fallos por defecto; comprueba también el formulario.

FormRenderer requiere recordKind

Publicado: 2026-10-28

Se aplica desde: form0-react 0.5.0, form0-react-native 0.6.0

Actúa si usas FormRenderer de form0-react o form0-react-native. Sin recordKind, lanza este error:

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

Qué hacer: Establece recordKind en "new" para un registro nuevo, o en "existing" al abrir uno guardado:

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

Los eventos del ciclo de vida y los eventos de foco y desenfoque de los campos ahora están activos por defecto, así que sus manejadores empiezan a ejecutarse. Los controles integrados no emiten click automáticamente. Para mantener el comportamiento anterior, desactiva estos eventos:

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

Compruébalo: Abre el formulario y confirma que se renderiza sin el error. Si usas manejadores del ciclo de vida, confirma que cada uno se ejecuta una vez.

Los manejadores no pueden cambiar un registro de solo lectura

Publicado: 2026-10-27

Se aplica desde: form0-core 0.8.0, form0-react 0.5.0, form0-react-native 0.6.0, form0-cli 0.8.0

Actúa si un manejador de load-record llama a SETVALUE() y el formulario puede abrirse en solo lectura. load-record se ejecuta en ambos modos.

Qué hacer: Mueve la escritura a new-record o 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")
})

También puedes conservar el manejador y comprobar event.mode:

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

Compruébalo: Abre el formulario con mode="readonly". Si un manejador sigue escribiendo, la consola muestra este mensaje y el formulario se abre sin los cambios de ese manejador: View-mode handlers cannot change record data.

Las condiciones solo pueden leer su propio registro y sus padres

Publicado: 2026-10-22

Se aplica desde: form0-core 0.6.0

Actúa si tu esquema tiene secciones repetibles y una condición lee un campo de fila desde fuera de esa fila. form0-core rechaza el esquema con un error como este:

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

Qué hacer: Haz que la condición apunte a un campo de la misma fila, de una fila padre o del formulario principal. Ámbitos padre e hijo incluye un ejemplo completo.

Compruébalo: Ejecuta este comando con cada esquema. Termina con el estado 1 y muestra el error si una condición está fuera de ámbito:

Code
form0 validate path/to/schema.json

Los editores de fila en móvil ya no ejecutan eventos de registro

Publicado: 2026-10-08

Se aplica desde: form0-react-native 0.3.0

Actúa si actualizas desde form0-react-native 0.2.x y un manejador depende de que load-record, edit-record o change se ejecuten dentro de una fila repetible.

Qué hacer: Mueve la lógica de fila a los eventos repetibles, usando el data_name de tu sección repetible:

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
})

Compruébalo: Abre una fila y confirma que tu manejador se ejecuta. Los manejadores del formulario principal ya no se ejecutan al abrir una fila.