Merge branch 'master' into split_packages

# Conflicts:
#	README.md
#	lib/flutter_form_builder.dart
#	lib/localization/form_builder_localizations.dart
#	packages/flutter_form_builder/CHANGELOG.md
#	packages/flutter_form_builder/pubspec.yaml

Author: danvick

packages/flutter_form_builder/CHANGELOG.md

@@ -15,6 +15,12 @@
 ## [7.0.0-alpha.0] - 16-May-2021
 * Split up packages - removed fields and validation from core
 
+## [6.2.0] - 21-Oct-2021
+* Fixed `didChange` unable to handle null value in  `FormBuilderTextField`
+
+**BREAKING CHANGE**
+* Added new attribute - `autoFocusOnValidationFailure` (default: `false`) - to FormBuilder to set whether should scroll to first error if validation fails
+
 ## [6.1.0] - 01-Sep-2021
 * When form validation fails, automatically scroll to first error
 * New way to programmatically induce custom errors by calling `GlobalKey<FormBuilderState>.invalidateField()` or `GlobalKey<FormBuilderFieldState>.invalidate()`

packages/flutter_form_builder/lib/src/fields/form_builder_date_range_picker.dart

@@ -183,7 +183,7 @@ class FormBuilderDateRangePicker extends FormBuilderField<DateTimeRange> {
     try {
       return format.format(date);
     } catch (e) {
-      // print('Error formatting date: $e');
+      // Ignore exception
     }
     return '';
   }
@@ -266,8 +266,8 @@ class FormBuilderDateRangePickerState
   }
 
   @override
-  void didChange(DateTimeRange? value) {
-    super.didChange(value);
+  void didChange(DateTimeRange? val) {
+    super.didChange(val);
     _setTextFieldString();
   }
 

packages/flutter_form_builder/lib/src/fields/form_builder_text_field.dart

@@ -465,7 +465,7 @@ class _FormBuilderTextFieldState
     super.didChange(value);
 
     if (_effectiveController!.text != value) {
-      _effectiveController!.text = value!;
+      _effectiveController!.text = value ?? '';
     }
   }
 

packages/flutter_form_builder/lib/src/form_builder.dart

@@ -58,6 +58,9 @@ class FormBuilder extends StatefulWidget {
   /// and their enabled state will be ignored.
   final bool enabled;
 
+  /// Whether the form should auto focus on the first field that fails validation.
+  final bool autoFocusOnValidationFailure;
+
   /// Creates a container for form fields.
   ///
   /// The [child] argument must not be null.
@@ -70,6 +73,7 @@ class FormBuilder extends StatefulWidget {
     this.initialValue = const <String, dynamic>{},
     this.skipDisabled = false,
     this.enabled = true,
+    this.autoFocusOnValidationFailure = false,
   }) : super(key: key);
 
   static FormBuilderState? of(BuildContext context) =>
@@ -152,7 +156,7 @@ class FormBuilderState extends State<FormBuilder> {
 
   bool validate() {
     final hasError = !_formKey.currentState!.validate();
-    if (hasError) {
+    if (hasError && widget.autoFocusOnValidationFailure) {
       final wrongFields =
           fields.values.where((element) => element.hasError).toList();
       wrongFields.first.requestFocus();

packages/flutter_form_builder/pubspec.yaml

@@ -4,7 +4,7 @@ version: 7.0.0-beta.0
 homepage: https://github.com/danvick/flutter_form_builder
 
 environment:
-  sdk: ">=2.12.0 <3.0.0"
+  sdk: '>=2.12.0 <3.0.0'
 
 dependencies:
   flutter:

packages/form_builder_validators/test/form_builder_validators_test.dart

@@ -8,7 +8,7 @@ import 'package:form_builder_validators/form_builder_validators.dart';
 Future<void> testValidations(
     WidgetTester tester, void Function(BuildContext) validations) async {
   await tester.pumpWidget(MaterialApp(
-    localizationsDelegates: [
+    localizationsDelegates: const [
       FormBuilderLocalizations.delegate,
       GlobalMaterialLocalizations.delegate,
       GlobalWidgetsLocalizations.delegate,
@@ -18,7 +18,7 @@ Future<void> testValidations(
         // Exercise validations using the provided context
         validations(context);
         // The builder function must return a widget.
-        return Placeholder();
+        return const Placeholder();
       },
     ),
   ));