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 react@16.3.0

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 final-form@4.7.3)

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 final-form@4.6.1.

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().

v3.2.1

v3.2.0 was broken. 😳

Features

• Handle prop changes to <Form> to update config in realtime. #183 #128
• Better dead code removal. #206
• Added better dev warning for checkbox and radio buttons. #204

v3.1.5

Bug Fixes

• Fixed pesky bug involving post-mount updates. #197 #196

Flow Fixes

• Exported more of the flow types, like FieldProps and FieldRenderProps. #200 #142