reactive_forms

Fixes

• Correct hasErrors to check child controls.

Enhances

• Improve errors getter performance.
• Optimize list and map access.

Features

• Allowed overwriting default value on reset. Added an overwriteDefaultValue parameter to the FormControl.reset() method. When overwriteDefaultValue is true, the value passed to reset() becomes the new default value for the control.
• Enhanced FormControl reset method. Introduced a nonNullable property to the FormControl constructor to control the behavior of the reset() method. When nonNullable is true (the default), calling reset() without a value will reset the control to its initial value. When nonNullable is false, calling reset() without a value will reset the control to null.
• Exposed defaultValue of the FormControl.

Fixes

• Fixed an issue where enabling or disabling a FormGroup and FormArray did not correctly propagate the enabled/disabled state to all of its child controls.

Fixes

• Fix NumberValidator to correctly handle decimal numbers with trailing zeros.
• Improve NumberValidator to correctly validate numbers with multiple decimal points, single dot, and dot at the end.

• Add oneOf validator to the list of validators.
• Add debounced async validator that allows to specify a custom debounce time for a single validator.
• The Validators.delegateAsync() function now accepts an optional debounceTime parameter, defaulting to 0. This allows immediate execution or custom debouncing for asynchronous validation.

Features

• Add allowNull optional parameter to the CompareValidator.
• The FormControl.reset() method has been updated to align with the common expectation that resetting a control without specifying a new value should revert it to its initial state.
• The reset method in AbstractControl (and by inheritance FormControl) has been updated to correctly handle the disabled state. If the disabled parameter is not provided to the reset method, the control's disabled status will now revert to the initial disabled value that was set when the control was constructed.

Fixes

• Fixed broken reactivity with the PopScope.

• Moved examples project out of the package's code, and uploaded to its own repo.

Breaking changes

• Upgraded Flutter minimum version to 3.29.0.
• Added missing fields to widgets:
  • ReactiveCheckbox: semanticLabel.
  • ReactiveCheckboxListTile: checkboxSemanticLabel.
  • ReactiveDatePicker: barrierColor, barrierDismissible, barrierLabel, switchToInputEntryModeIcon, switchToCalendarEntryModeIcon, onDatePickerModeChange.
  • ReactiveTimePicker: barrierColor, barrierDismissible, barrierLabel, orientation, switchToInputEntryModeIcon, switchToTimerEntryModeIcon.
  • ReactiveForm: onPopInvokedWithResult (used in PopScope), removed deprecated onPopInvoked.
  • ReactiveFormPopScope: onPopInvokedWithResult (used in PopScope), removed deprecated onPopInvoked.
  • ReactiveFormBuilder: onPopInvokedWithResult (used in PopScope), removed deprecated onPopInvoked.
  • ReactiveRadioListTile: radioScaleFactor.
  • ReactiveSlider: padding, allowedInteraction.
  • ReactiveSwitch: padding, trackOutlineWidth.
  • ReactiveSwitch.adaptive: thumbIcon, trackOutlineWidth, trackOutlineColor, padding, applyCupertinoTheme, onFocusChange.
  • ReactiveTextField: groupId, ignorePointers, cursorErrorColor, stylusHandwritingEnabled (removed deprecated scribbleEnabled), onTapAlwaysCalled, onTapUpOutside, statesController
• Renamed ReactiveSwitchListTile.adaptative to ReactiveSwitchListTile.adaptive

Fixes

• Added const keyword to DefaultPatternEvaluator and RegExpPatternEvaluator constructors.

• Reduce intl dependency constraint to match Flutter 3.16.0.
• NumberValidator allows null values.

Breaking changes

• Removed deprecated onWillPop from ReactiveForm and ReactiveFormBuilder widgets. It was replaced with the PopScope widget.
• Validators.number allows now to define negative numbers and decimal numbers with the addition of two optional arguments allowNegatives and allowedDecimals.

Features

• Add canPop and onPopInvoked to ReactiveForm and ReactiveFormBuilder widgets.

Fixes

• Add default Context Menu to ReactiveTextField.

Features

• Add markAsPending() method to AbstractControl to allow set the status to PENDING by demand.

Fixes

• Add missing properties to ReactiveSwitchListTile.adaptative() widget.
• Add showError() to ReactiveCheckbox and ReactiveCheckboxListTile widgets. This does not display any error messages but it is now compatible with the Flutter builtin behavior of Checkboxes when Material 3 is enabled (ThemeData(useMaterial3: true)) in the active App Theme.

Enhances

• Update Readme.md file with testing examples in the section ReactiveForm vs ReactiveFormBuilder which one?

Fixes

• Fix an issue with FormGroup and FormArray were recursive Raw Value was not working properly.

Fixes

• Fix an issue with FormBuilder when trying to build a control with a nullable '?' data type.
• Fix an issue with FormGroup that was not triggering the event collectionChanges when a control is removed.
• Fix an issue with FormGroup and FormArray when trying to find a control with a nullable '?' data type.

Fixes

• Update the intl dependency version, because in flutter 3.10, flutter_localizations depends on intl 0.18.0.

Breaking Changes

• Flutter >= 3.10 required for this version.

Fixes

• Updated some documentation.
• Expose validator classes to allow direct instantiation.

Breaking Changes

• All validators have been changed to classes with const constructors.
• The Asynchronous Validator is now a class from where any custom async validator can inherit.

Features

• A new validator Validators.delegate(...) has been introduced to be used with a custom validation function.
• A new validator Validators.delegateAsync(...) has been introduced to be used with a custom async validation functions.

• Fix the inkwell ripple effect in the ReactiveDropdownField.
• Add some other minor fixes.

• Update intl to latest version 0.18.0.

Enhances

• Create new widget ReactiveFocusableFormField as a parent widget for all other widgets that requires to do focus management.

Breaking Changes

• The definition of validation messages is now more consistent.
• Methods like onTab in ReactiveTextField and onChanged in ReactiveDropdownField now provides the control as argument of the callback.

Enhances

• Add events like onChanged, onEditingComplete to reactive widgets.

Features

• Add widget ReactiveFormConfig to globally define validation messages at Flutter application level. This reliefs the need to define validation messages in each reactive widget.

Breaking Changes

• Reactive Forms is now migrated to Flutter 3.0.0.

Fix

• Update project to new Android wrappers in order to be able to run the example using latest Android SDK changes.

Enhances

• Add Focus handling for several reactive widgets:
  • ReactiveSlider
  • ReactiveSwitch
  • ReactiveRadio
  • ReactiveRadioListTile
  • ReactiveCheckbox
  • ReactiveCheckboxListTile

Fix

• Fix issues in ReactiveDatePicker when control value was before or after the range of firstDate and lastDate

Enhances

• Add optional argument initialDate to the ReactiveDatePicker.

Breaking Changes

• Reactive Forms is now migrated to Flutter 2.8.0.

Enhances

• Update reactive widgets with extra properties presents in Flutter 2.8.0.

Features

• Expose TextEditingController as a property of the ReactiveTextField for text selection purposes only.

Fix

• Fix Async Validators that overrides validations errors from Sync Validators

Enhances

• Improve Complex example in the demo application

Enhances

• Improve the Array example in the demo application
• Better exception handler when creating FormGroups with controls that contains character '.' in the name of the control.

Enhances

• Add an example of deleting item from a FormArray in the example folder project.
• Make public the previously private class InheritedStreamer

Fix

• Minor documentation fix.

Enhances

• Add documentation of new advanced reactive widgets.

Fix

• Minor documentation fix.

Enhances

• Converted ReactiveForm widget from Stateful to Stateless widget.

Enhances

• Update the lint code analysis to use the las package lints.
• Minor internal code checks and improvements.

Enhances

• Added optional argument to Validators.mustMatch that allows to define if we want to mark the matchingControlName control as DIRTY when the control is invalid. See related issue.
• Minor changes in model classes that allows to create custom AbstractControl implementations

Enhances

• Added missing props pass through for widgets.

Enhances

• Add minor internal changes for handling focus node in reactive text fields.

Fix

• Add Flutter sdk version restriction in pubspec.yaml file.
• Fix Validators.compare in release mode that has different behavior from debug mode.

Features

• Add method in FormGroup that allows to remove a control by its name.

Enhances

• Add missing extra properties to ReactiveRadioListTile and ReactiveRadio widgets.
• Add a SliderIntValueAccessor that allows ReactiveSlider to bind to controls of type int.

Fix

• Fix error when defining a ReactiveTextField with dynamic type and bound the widget with controls other than String.

Enhances

• Add the optionally extra argument autoValidate to the method AbstractControl.setValidators to recalculate the validaity of the control after set the new validators without explicitly call updateValueAndValidity on that control.

Features

• Add/Clear validators dynamically

Fix

• Fix error when defining a ReactiveTextField without specifying a model data type

Enhances

• Change the data type of ValidatorFunction to returns Map<String, dynamic> instead of Map<String, Object>

Fix

• Fix exception when focus a control that does not exist in a group

Enhances

• Better type definition in a control value accessor within a ReactiveFormField

Fix

• Set ReactiveTextField maxLines as optional nullable argument.

Enhances

• Add minor changes in Validators.min and Validators.max for handlig type checks
• Add minor changes in ReactiveValueListenableBuilder for handlig type checks

Fix

• Fix the error when defining a ReactiveFormField<dynamic> (related to control value accessor)

Breaking changes

• Reactive Forms is now migrated to Flutter 2.x.
• Reactive Forms is now Null-safety.
• New Definitions in Custom Reactive Widgets. ReactiveFormField now defines the data type of the model (control) and the data type of the view (widget).
• Validators.requiredTrue now has the 'requiredTrue' validation message and not 'requiredEquals' as in previous versions.

Features

• Now you can specify a different validation message to the Validators.pattern validator.

Enhances

• Add latest version of intl package

Fix

• Remove Validators String type to fix casts errors when calling form.control('').validators in a control with a non dynamic type validator.

Fix

• Add minor changes to successfully pass pub dev static analysis.
• Add Library documentation.

Breaking changes

• An enhanced strongly typed system to improve casting at compilation time and improve casting exception handler in runtime. This version was created to be compatible with analysis options in "implicit-casts: false" and "implicit-dynamic: false".

Fix

• Code formatting issues

Fix

• Validators.pattern now validates against a RegExp instance.

Fix

• If a control is disabled, then it doesn't fire state change again when call markAsDisabled.

Breaking changes

• Upgrade Reactive Forms to Flutter 1.20

Features

• Add intl package and and optional argument to DateTimeValueAccessor to specify the format of the date.
• Add some extra properties to reactive forms widgets.

Fix

• Set cursor at the end of the text when set value to reactive text field from the FormControl.

Fix

• Exposes ReactiveSwitchListTile.

Fix

• Fix code formatting to pass pub static analysis.

Features

• Expose focus controller of the FormControl. Now is possible to access UI FocusNode with in a control through control.focusController.focusNode.

Features

• Add argument focusNode to ReactiveTextField to provide a custom FocusNode.

Enhances

• Add some improvement to TimeOfDayValueAccessor.
• Add some improvement to example application.