Merge branch 'release/16.0.4'

CHANGELOG.md

@@ -1,3 +1,17 @@
+# 16.0.4
+
+## 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?`
+
 # 16.0.3
 
 ## Fixes

README.md

@@ -88,7 +88,7 @@ dependencies:
   flutter:
     sdk: flutter
 
-  reactive_forms: ^16.0.3
+  reactive_forms: ^16.0.4
 ```
 
 Then run the command `flutter packages get` on the console.

example/android/build.gradle

@@ -26,6 +26,6 @@ subprojects {
     project.evaluationDependsOn(':app')
 }
 
-task clean(type: Delete) {
+tasks.register("clean", Delete) {
     delete rootProject.buildDir
 }

example/lib/main.dart

@@ -40,7 +40,14 @@ class ReactiveFormsApp extends StatelessWidget {
         'uniqueEmail': (_) => 'This email is already in use',
       },
       child: MaterialApp(
-        theme: customTheme,
+        theme: ThemeData(
+          useMaterial3: true,
+          inputDecorationTheme: const InputDecorationTheme(
+            border: OutlineInputBorder(),
+            floatingLabelBehavior: FloatingLabelBehavior.auto,
+            alignLabelWithHint: true,
+          ),
+        ),
         routes: <String, WidgetBuilder>{
           Routes.complex: (_) => ComplexSample(),
           Routes.simple: (_) => SimpleSample(),
@@ -55,11 +62,3 @@ class ReactiveFormsApp extends StatelessWidget {
     );
   }
 }
-
-final customTheme = ThemeData.light().copyWith(
-  inputDecorationTheme: const InputDecorationTheme(
-    border: OutlineInputBorder(),
-    floatingLabelBehavior: FloatingLabelBehavior.auto,
-    alignLabelWithHint: true,
-  ),
-);

example/lib/samples/complex_sample.dart

@@ -49,6 +49,7 @@ class ComplexSample extends StatelessWidget {
         form: buildForm,
         builder: (context, form, child) {
           return Column(
+            crossAxisAlignment: CrossAxisAlignment.stretch,
             children: [
               ReactiveTextField<String>(
                 formControlName: 'email',

example/lib/samples/login_sample.dart

@@ -8,7 +8,10 @@ class LoginSample extends StatelessWidget {
           validators: [Validators.required, Validators.email],
         ),
         'password': ['', Validators.required, Validators.minLength(8)],
-        'rememberMe': false,
+        'acceptTerms': FormControl<bool>(
+          value: false,
+          validators: [Validators.requiredTrue],
+        ),
       });
 
   @override
@@ -19,6 +22,7 @@ class LoginSample extends StatelessWidget {
         form: buildForm,
         builder: (context, form, child) {
           return Column(
+            crossAxisAlignment: CrossAxisAlignment.stretch,
             children: [
               ReactiveTextField<String>(
                 formControlName: 'email',
@@ -55,11 +59,10 @@ class LoginSample extends StatelessWidget {
                   errorStyle: TextStyle(height: 0.7),
                 ),
               ),
-              Row(
-                children: [
-                  ReactiveCheckbox(formControlName: 'rememberMe'),
-                  const Text('Remember me')
-                ],
+              const SizedBox(height: 16.0),
+              ReactiveCheckboxListTile(
+                formControlName: 'acceptTerms',
+                title: const Text('Accept terms & conditions'),
               ),
               const SizedBox(height: 16.0),
               ElevatedButton(
@@ -72,12 +75,16 @@ class LoginSample extends StatelessWidget {
                 },
                 child: const Text('Sign Up'),
               ),
+              const SizedBox(height: 16.0),
               ElevatedButton(
-                onPressed: () => form.resetState({
-                  'email': ControlState<String>(value: null),
-                  'password': ControlState<String>(value: null),
-                  'rememberMe': ControlState<bool>(value: false),
-                }, removeFocus: true),
+                onPressed: () => form.resetState(
+                  {
+                    'email': ControlState<String>(value: null),
+                    'password': ControlState<String>(value: null),
+                    'acceptTerms': ControlState<bool>(value: false),
+                  },
+                  removeFocus: true,
+                ),
                 child: const Text('Reset all'),
               ),
             ],

lib/src/widgets/reactive_checkbox.dart

@@ -7,21 +7,19 @@ import 'package:reactive_forms/reactive_forms.dart';
 
 /// This is a convenience widget that wraps a [Checkbox] widget in a
 /// [ReactiveCheckbox].
-///
-/// Can optionally provide a [formControl] to bind this widget to a control.
-///
-/// Can optionally provide a [formControlName] to bind this ReactiveFormField
-/// to a [FormControl].
-///
-/// Must provide one of the arguments [formControl] or a [formControlName],
-/// but not both at the same time.
-///
-/// For documentation about the various parameters, see the [Checkbox] class
-/// and [Checkbox], the constructor.
 class ReactiveCheckbox extends ReactiveFocusableFormField<bool, bool> {
   /// Create an instance of a [ReactiveCheckbox].
   ///
-  /// The [formControlName] arguments must not be null.
+  /// Can optionally provide a [formControl] to bind this widget to a control.
+  ///
+  /// Can optionally provide a [formControlName] to bind this ReactiveFormField
+  /// to a [FormControl].
+  ///
+  /// Must provide one of the arguments [formControl] or a [formControlName],
+  /// but not both at the same time.
+  ///
+  /// For documentation about the various parameters, see the [Checkbox] class
+  /// and the [Checkbox] constructor.
   ReactiveCheckbox({
     Key? key,
     String? formControlName,
@@ -42,11 +40,15 @@ class ReactiveCheckbox extends ReactiveFocusableFormField<bool, bool> {
     OutlinedBorder? shape,
     BorderSide? side,
     ReactiveFormFieldCallback<bool>? onChanged,
+    ShowErrorsFunction<bool>? showErrors,
   }) : super(
           key: key,
           formControl: formControl,
           formControlName: formControlName,
           focusNode: focusNode,
+          showErrors: showErrors ??
+              (control) =>
+                  control.invalid && (control.dirty || control.touched),
           builder: (field) {
             return Checkbox(
               value: tristate ? field.value : field.value ?? false,
@@ -65,7 +67,7 @@ class ReactiveCheckbox extends ReactiveFocusableFormField<bool, bool> {
               focusNode: field.focusNode,
               shape: shape,
               side: side,
-              isError: !field.control.valid,
+              isError: field.errorText != null,
               onChanged: field.control.enabled
                   ? (value) {
                       field.didChange(value);

lib/src/widgets/reactive_checkbox_list_tile.dart

@@ -7,23 +7,19 @@ import 'package:reactive_forms/reactive_forms.dart';
 
 /// This is a convenience widget that wraps a [CheckboxListTile] widget in a
 /// [ReactiveCheckboxListTile].
-///
-/// Can optionally provide a [formControl] to bind this widget to a control.
-///
-/// Can optionally provide a [formControlName] to bind this ReactiveFormField
-/// to a [FormControl].
-///
-/// Must provide one of the arguments [formControl] or a [formControlName],
-/// but not both at the same time.
-///
-/// For documentation about the various parameters, see the [CheckboxListTile]
-/// class and [CheckboxListTile], the constructor.
 class ReactiveCheckboxListTile extends ReactiveFocusableFormField<bool, bool> {
   /// Create an instance of a [ReactiveCheckbox].
   ///
-  /// The [formControlName] arguments must not be null.
+  /// Can optionally provide a [formControl] to bind this widget to a control.
   ///
-  /// See also [CheckboxListTile]
+  /// Can optionally provide a [formControlName] to bind this ReactiveFormField
+  /// to a [FormControl].
+  ///
+  /// Must provide one of the arguments [formControl] or a [formControlName],
+  /// but not both at the same time.
+  ///
+  /// For documentation about the various parameters, see the [CheckboxListTile]
+  /// class and the [CheckboxListTile] constructor.
   ReactiveCheckboxListTile({
     Key? key,
     String? formControlName,
@@ -56,11 +52,15 @@ class ReactiveCheckboxListTile extends ReactiveFocusableFormField<bool, bool> {
     double? splashRadius,
     MaterialTapTargetSize? materialTapTargetSize,
     ValueChanged<bool>? onFocusChange,
+    ShowErrorsFunction<bool>? showErrors,
   }) : super(
           key: key,
           formControl: formControl,
           formControlName: formControlName,
           focusNode: focusNode,
+          showErrors: showErrors ??
+              (control) =>
+                  control.invalid && (control.dirty || control.touched),
           builder: (field) {
             return CheckboxListTile(
               value: tristate ? field.value : field.value ?? false,
@@ -73,7 +73,7 @@ class ReactiveCheckboxListTile extends ReactiveFocusableFormField<bool, bool> {
               activeColor: activeColor,
               checkColor: checkColor,
               onFocusChange: onFocusChange,
-              isError: !field.control.valid,
+              isError: field.errorText != null,
               title: title,
               subtitle: subtitle,
               isThreeLine: isThreeLine,
@@ -92,6 +92,7 @@ class ReactiveCheckboxListTile extends ReactiveFocusableFormField<bool, bool> {
               enableFeedback: enableFeedback,
               checkboxShape: checkboxShape,
               side: side,
+              enabled: field.control.enabled,
               onChanged: field.control.enabled
                   ? (value) {
                       field.didChange(value);

lib/src/widgets/reactive_dropdown_field.dart

@@ -5,7 +5,7 @@
 import 'package:flutter/material.dart';
 import 'package:reactive_forms/reactive_forms.dart';
 
-/// A reactive widget that wraps a [DropdownButton].
+/// A reactive widget that wraps a [DropdownButtonFormField].
 class ReactiveDropdownField<T> extends ReactiveFocusableFormField<T, T> {
   /// Creates a [DropdownButton] widget wrapped in an [InputDecorator].
   ///
@@ -20,7 +20,10 @@ class ReactiveDropdownField<T> extends ReactiveFocusableFormField<T, T> {
   /// If [readOnly] is true, the button will be disabled, the down arrow will
   /// be grayed out, and the disabledHint will be shown (if provided).
   ///
-  /// The [DropdownButton] [items] parameters must not be null.
+  /// The [items] parameter must not be null.
+  ///
+  /// For more information about all various parameters,
+  /// see [DropdownButtonFormField] constructor.
   ReactiveDropdownField({
     Key? key,
     String? formControlName,
@@ -50,6 +53,7 @@ class ReactiveDropdownField<T> extends ReactiveFocusableFormField<T, T> {
     bool? enableFeedback,
     AlignmentGeometry alignment = AlignmentDirectional.centerStart,
     BorderRadius? borderRadius,
+    EdgeInsetsGeometry? padding,
     ReactiveFormFieldCallback<T>? onTap,
     ReactiveFormFieldCallback<T>? onChanged,
   })  : assert(itemHeight == null || itemHeight > 0),
@@ -111,6 +115,7 @@ class ReactiveDropdownField<T> extends ReactiveFocusableFormField<T, T> {
               enableFeedback: enableFeedback,
               alignment: alignment,
               borderRadius: borderRadius,
+              padding: padding,
               onTap: onTap != null ? () => onTap(field.control) : null,
               onChanged: isDisabled
                   ? null

lib/src/widgets/reactive_switch_list_tile.dart

@@ -136,18 +136,31 @@ class ReactiveSwitchListTile extends ReactiveFocusableFormField<bool, bool> {
     String? formControlName,
     FormControl<bool>? formControl,
     Color? activeColor,
-    ImageProvider? activeThumbImage,
     Color? activeTrackColor,
+    Color? inactiveThumbColor,
+    Color? inactiveTrackColor,
+    ImageProvider? activeThumbImage,
+    ImageErrorListener? onActiveThumbImageError,
+    ImageProvider? inactiveThumbImage,
+    ImageErrorListener? onInactiveThumbImageError,
+    MaterialStateProperty<Color?>? thumbColor,
+    MaterialStateProperty<Color?>? trackColor,
+    MaterialStateProperty<Color?>? trackOutlineColor,
+    MaterialStateProperty<Icon?>? thumbIcon,
+    MaterialTapTargetSize? materialTapTargetSize,
+    DragStartBehavior dragStartBehavior = DragStartBehavior.start,
+    MouseCursor? mouseCursor,
+    MaterialStateProperty<Color?>? overlayColor,
+    double? splashRadius,
     bool autofocus = false,
+    bool? applyCupertinoTheme,
     EdgeInsetsGeometry? contentPadding,
     ListTileControlAffinity controlAffinity = ListTileControlAffinity.platform,
     bool? dense,
     bool? enableFeedback,
     FocusNode? focusNode,
+    ValueChanged<bool>? onFocusChange,
     Color? hoverColor,
-    Color? inactiveThumbColor,
-    ImageProvider? inactiveThumbImage,
-    Color? inactiveTrackColor,
     bool isThreeLine = false,
     Widget? secondary,
     bool selected = false,
@@ -167,18 +180,31 @@ class ReactiveSwitchListTile extends ReactiveFocusableFormField<bool, bool> {
             return SwitchListTile.adaptive(
               value: field.value ?? false,
               activeColor: activeColor,
-              activeThumbImage: activeThumbImage,
               activeTrackColor: activeTrackColor,
+              inactiveThumbColor: inactiveThumbColor,
+              inactiveTrackColor: inactiveTrackColor,
+              activeThumbImage: activeThumbImage,
+              onActiveThumbImageError: onActiveThumbImageError,
+              inactiveThumbImage: inactiveThumbImage,
+              onInactiveThumbImageError: onInactiveThumbImageError,
+              thumbColor: thumbColor,
+              trackColor: trackColor,
+              trackOutlineColor: trackOutlineColor,
+              thumbIcon: thumbIcon,
+              materialTapTargetSize: materialTapTargetSize,
+              dragStartBehavior: dragStartBehavior,
+              mouseCursor: mouseCursor,
+              overlayColor: overlayColor,
+              splashRadius: splashRadius,
               autofocus: autofocus,
+              applyCupertinoTheme: applyCupertinoTheme,
               contentPadding: contentPadding,
               controlAffinity: controlAffinity,
               dense: dense,
               enableFeedback: enableFeedback,
               focusNode: field.focusNode,
+              onFocusChange: onFocusChange,
               hoverColor: hoverColor,
-              inactiveThumbColor: inactiveThumbColor,
-              inactiveThumbImage: inactiveThumbImage,
-              inactiveTrackColor: inactiveTrackColor,
               isThreeLine: isThreeLine,
               secondary: secondary,
               selected: selected,

pubspec.yaml

@@ -1,6 +1,6 @@
 name: reactive_forms
 description: This is a model-driven approach to handling form inputs and validations, heavily inspired in Angular Reactive Forms.
-version: 16.0.3
+version: 16.0.4
 homepage: "https://github.com/joanpablo/reactive_forms"
 
 environment: