v3.6.2

React 15 Compatibility

Previous versions were a little too premature in adopting the UNSAFE_ lifecycle prefixes, resulting in incompatibility with React 15. This release fixes that and should restore compatibility with React 15.

v3.6.1

Bug Fix

• 🤦‍♂️ Actually use react-lifecycles-compat polyfill that was added in previous version #277

v3.6.0

New Features

• New formatOnBlur prop that will cause format to only be run when a value is blurred. This is hugely useful for formatting numbers, where you want a user to be able to type "3." on their way to "3.14" without having the format function erase the decimal point in formatting. #274 #187

v3.5.2

Fixes

• Removed need to enumerate each final-form config option in react-final-form, so that new FF config properties can be added without require a RFF version bump. #272
• Added UNSAFE_ prefixes for compatibility with [email protected]

v3.5.1

Bug Fixes

• Actually accept and pass along the new keepDirtyOnReinitialize config prop to final-form. #265

v3.5.0

New Features

• New keepDirtyOnReinitialize config flag #246 (requires peer dependency of [email protected])

v3.4.2

Bug fixes

• v3.4.0 includes a potential bug that would unpause validation on componentDidUpdate() #237

Requires a peer dep to the latest version of [email protected].

v3.4.0

Type Fixes

• Fixed handleSubmit flow type #233
• Added missing meta.data flow and typescript type. #229

Performance Improvements

• Fixed major performance problem when initially mounting a form with many fields. #236

Check out the before and after performance with relation to Formik:

You can run this performance test yourself here:

v3.3.1

Bug Fixes

• Accidentally removed meta.data value in v3.3.0. It's back now. #225

v3.3.0

API Deprecation

Deprecated the render props following given by Form and FormSpy:

• batch
• blur
• change
• focus
• initialize
• mutators
• reset

They can all now be found under the form prop, which is the full FormApi provided by 🏁 Final Form. This way, if the 🏁 Final Form API changes, 🏁 React Final Form does not necessarily need to be updated. It also gives you much more control as the library user.

All of these deprecations will now generate warnings in development, and will be removed from the next major release.

Migration

Any place you were using props.change(), you will need to change it to props.form.change().