This release comes with a minor behavior change around initializing values.
Behavior Change
Following a rousing debate on #370, it was concluded, #370 (comment), that:
- Initializing a form should update both the fields'
initial
andvalue
values, thus guaranteeing thatpristine
istrue
after initializing. - A form should only be initialized on mount with the contents of the
initialValues
prop if that particular form has never been initialized before. This way, if you disabledestroyOnUnmount
, you may remount the form component with aninitialValues
prop without having your previously initialized values blown away.
If you require that your form be initialized on mount even if it has previously been initialized, you will have to call this.props.initializeForm(values)
manually.