New Features

• A new dirtySinceLastSubmit flag is available to both the form and fields, which lets you know if the values have change since the last submit occurred, whether successful or not. This is particularly useful for hiding submission errors once the user has attempted to fix them. #57 #4 #38 #48

Typescript

• Improved typescript typings #53 #54

⚠️ BREAKING CHANGE ⚠️

onSubmit is now passed the form api as well as the values. #47 https://github.com/final-form/react-final-form/issues/69

In v2.x.x:

createForm({
  onSubmit: (values) => {
    const promise = sendToServer(values)
    return promise
  }
})

OR

createForm({
  onSubmit: (values, callback) => {
    sendToServer(values, callback)
  }
})

In v3.x.x:

createForm({
  onSubmit: (values, form) => {
//                 ^^^^^^^ -------------------- 🆕
    const promise = sendToServer(values)
    return promise
  }
})

OR

createForm({
  onSubmit: (values, form, callback) => {
//                 ^^^^^^^ -------------------- 🆕
    sendToServer(values, callback)
  }
})

New Features

• Each field can now specify its own isEqual function for calculating pristine and dirty. This enables arbitrary values. Defaults to ===. #46 https://github.com/final-form/react-final-form/issues/59
• Each field can now provide a list of other fields for which to run field-level validation when the current field changes. #46 #37

⚠️ BREAKING CHANGE ⚠️

In v1.x.x:

form.registerField(
  name,
  subscriber,
  subscription,
  validate
)

In v2.x.x:

form.registerField(
  name,
  subscriber,
  subscription,
  {
    isEqual,
    validate,
    validateFields
  }
)

Bug Fixes

• Fixed bug where items were removed from arrays when the item's keys were empty. #33 #32
• Fixed bug where sync errors were not showing up for deep array fields. #34 https://github.com/final-form/react-final-form-arrays/issues/3

Something went wrong in the publishing of v1.3.4. This release actually has its fix published properly. 😳

⚠️ Don't use this version. Use v1.3.4. ⚠️

Bug Fixes

• Fixed bug involving field-level validation with deep array values. #31 https://github.com/final-form/react-final-form-arrays/issues/3

🎉 TypeScript types 🎉

Courtesy of #30.

Bug Fixes

• Included missing data value in field state. #28
• Ensured that a field is still registered before setting an async error on it. #29 https://github.com/final-form/react-final-form/issues/49

Features

• Added Decorator type #24
• Added getRegisteredFields() function #25

Bug Fixes

• Allow a field to be marked as touched even if it was never active #15 https://github.com/erikras/react-final-form/issues/22
• Fixed bug in sync error not properly blocking submissions #16 https://github.com/final-form/react-final-form/issues/17 https://github.com/final-form/react-final-form/issues/3

Features

🎉 OMG MUTATORS!!! 🎉

• New mutator support that allows third party functions to manipulate form state.
• Field-level arbitrary data storage, for mutators to provide extensible functionality.

Features

• Added errors and submitErrors objects as form state that can be subscribed to #10 #5

Flow Fixes

• Brand new $Shape syntax for subscriptions and reported state. #2

Docs

• Met Github community standards. #3
• Added Example #7 #6

🎉 Initial Release! 🎉