implement notInList validators and add more migration guide items.

Author: ArturAssisComp

README-updated.md

@@ -156,6 +156,7 @@ TextFormField(
 Validators that check a generic type user input.
 
 - `Validators.inList(values)`: Checks if the field contains a value that is in the list `values`.
+- TODO [ ] `Validators.notInList(values)`: Checks if the field DOES NOT contain a value that is in the list `values`.
 - `Validators.isTrue()`: Checks if the field contains a boolean or a parsable `String` of the `true` value.
 - `Validators.isFalse()`: Checks if the field contains a boolean or a parsable `String` of the `false` value.
 

doc/migration.md

@@ -673,8 +673,56 @@ Validators.iban(ibanMsg: (_)=>'invalid iban');
 
 ### Identity validators
 
-- `FormBuilderValidators.city()` - requires the field's value to be a valid city name.
-- `FormBuilderValidators.country()` - requires the field's value to be a valid country name.
+- `FormBuilderValidators.city()`: there is no equivalent to [this validator](https://github.com/flutter-form-builder-ecosystem/form_builder_validators/blob/17e982bb849dc68365f8fbc93d5a2323ee891c89/lib/src/identity/city_validator.dart#L53). Something close would be:
+```dart
+/// Old API:
+FormBuilderValidators.city(
+  regex: RegExp(r'^[A-Z][a-zA-Z\s]+$'),
+  citiesWhitelist: ['CityA', 'CityB', 'CityC'],
+  citiesBlacklist: ['CityD', 'CityE'],
+  errorText: 'invalid city',
+);
+
+/// New API (expects input as String):
+Validators.and([
+  Validators.match(
+    RegExp(r'^[A-Z][a-zA-Z\s]+$'),
+    matchMsg: (_)=>'invalid city'
+  ),
+  Validators.inList(
+    ['CityA', 'CityB', 'CityC'],
+    inListMsg: (_, __) => 'invalid city',
+  ),
+  Validators.notInList(
+    ['CityD', 'CityE'],
+    notInListMsg: (_, __) => 'invalid city',
+  ),
+]);
+```
+
+- `FormBuilderValidators.country()`: there is no equivalent to [this validator](https://github.com/flutter-form-builder-ecosystem/form_builder_validators/blob/17e982bb849dc68365f8fbc93d5a2323ee891c89/lib/src/identity/country_validator.dart#L42). Something close would be:
+```dart
+/// Old API:
+FormBuilderValidators.country(
+  countryWhitelist: ['CountryA', 'CountryB', 'CountryC'],
+  countryBlacklist: ['CountryD', 'CountryE'],
+  errorText: 'invalid country',
+);
+
+/// New API (expects input as String):
+Validators.and([
+  Validators.inList(
+    ['CountryA', 'CountryB', 'CountryC'],
+    inListMsg: (_, __) => 'invalid country',
+  ),
+  Validators.notInList(
+    ['CountryD', 'CountryE'],
+    notInListMsg: (_, __) => 'invalid country',
+  ),
+]);
+```
+
+TODO continue from here...
 - `FormBuilderValidators.firstName()` - requires the field's value to be a valid first name.
 - `FormBuilderValidators.lastName()` - requires the field's value to be a valid last name.
 - `FormBuilderValidators.passportNumber()` - requires the field's value to be a valid passport number.

example/lib/generic_examples.dart

@@ -1,6 +1,6 @@
 import 'package:flutter/material.dart';
 import 'package:form_builder_validators/form_builder_validators.dart'
-    show Validators, Validator;
+    show Validator, Validators;
 
 /// alias for Validators class.
 typedef V = Validators;
@@ -248,6 +248,31 @@ class GenericExamplesPage extends StatelessWidget {
                 textInputAction: TextInputAction.done,
                 autovalidateMode: AutovalidateMode.always,
               ),
+              TextFormField(
+                decoration: const InputDecoration(
+                  labelText: 'City',
+                  prefixIcon: Icon(Icons.location_city),
+                ),
+                validator: V.required(
+                  V.and(<Validator<String>>[
+                    V.match(
+                      RegExp(r'^[A-Z][a-zA-Z\s]+$'),
+                      matchMsg: (_) => 'invalid city',
+                    ),
+                    V.inList(
+                      <String>['CityA', 'CityB', 'CityC'],
+                      inListMsg: (_, __) => 'invalid city',
+                    ),
+                    V.notInList(
+                      <String>['CityD', 'CityE'],
+                      notInListMsg: (_, __) => 'invalid city',
+                    ),
+                  ]),
+                  'invalid city',
+                ),
+                textInputAction: TextInputAction.done,
+                autovalidateMode: AutovalidateMode.always,
+              ),
             ],
           ),
         ),

lib/l10n/intl_ar.arb

@@ -62,6 +62,7 @@
   "startsWithErrorText": "القيمة يجب أن تبدأ بـ {value}.",
   "endsWithErrorText": "القيمة يجب أن تنتهي بـ {value}.",
   "containsErrorText": "القيمة يجب أن تحتوي على {value}.",
+  "doesNotContainElementErrorText": "القيمة قد لا تكون في القائمة.",
   "betweenErrorText": "القيمة يجب أن تكون بين {min} و {max}.",
   "containsElementErrorText": "القيمة يجب أن تكون ضمن القائمة المسموح بها.",
   "ibanErrorText": "هذا الحقل يتطلب IBAN صالح.",

lib/l10n/intl_bg.arb

@@ -64,6 +64,7 @@
   "containsErrorText": "Стойността трябва да съдържа {value}.",
   "betweenErrorText": "Стойността трябва да е между {min} и {max}.",
   "containsElementErrorText": "Стойността трябва да е в списъка с допустими стойности.",
+  "doesNotContainElementErrorText": "Стойността не може да бъде в списъка.",
   "ibanErrorText": "Това поле изисква валиден IBAN.",
   "uniqueErrorText": "Това поле изисква уникална стойност.",
   "bicErrorText": "Това поле изисква валиден BIC код.",

lib/l10n/intl_bn.arb

@@ -64,6 +64,7 @@
   "containsErrorText": "মানটি {value} ধারণ করতে হবে।",
   "betweenErrorText": "মানটি {min} এবং {max} এর মধ্যে হতে হবে।",
   "containsElementErrorText": "মানটি অনুমোদিত তালিকার মধ্যে থাকতে হবে।",
+  "doesNotContainElementErrorText": "মান তালিকায় থাকতে পারবে না।",
   "ibanErrorText": "একটি বৈধ IBAN প্রয়োজন।",
   "uniqueErrorText": "মানটি অবশ্যই অনন্য মানগুলির মধ্যে অদ্বিতীয় হতে হবে।",
   "bicErrorText": "একটি বৈধ BIC প্রয়োজন।",

lib/l10n/intl_bs.arb

@@ -64,6 +64,7 @@
   "containsErrorText": "Vrijednost mora sadržavati {value}.",
   "betweenErrorText": "Vrijednost mora biti između {min} i {max}.",
   "containsElementErrorText": "Vrijednost mora biti na listi dopuštenih vrijednosti.",
+  "doesNotContainElementErrorText": "Vrijednost ne smije biti na listi.",
   "ibanErrorText": "Unesite validan IBAN.",
   "uniqueErrorText": "Vrijednost mora biti jedinstvena.",
   "bicErrorText": "Unesite validan BIC.",

lib/l10n/intl_ca.arb

@@ -64,6 +64,7 @@
   "containsErrorText": "El valor ha de contenir {value}.",
   "betweenErrorText": "El valor ha d'estar entre {min} i {max}.",
   "containsElementErrorText": "El valor ha d'estar en la llista de valors permesos.",
+  "doesNotContainElementErrorText": "El valor no pot estar a la llista.",
   "ibanErrorText": "Aquest camp requereix un IBAN vàlid.",
   "uniqueErrorText": "Aquest camp requereix un valor únic.",
   "bicErrorText": "Aquest camp requereix un codi BIC vàlid.",

lib/l10n/intl_cs.arb

@@ -64,6 +64,7 @@
   "containsErrorText": "Hodnota musí obsahovat {value}.",
   "betweenErrorText": "Hodnota musí být mezi {min} a {max}.",
   "containsElementErrorText": "Hodnota musí být v seznamu povolených hodnot.",
+  "doesNotContainElementErrorText": "Hodnota nesmí být v seznamu.",
   "ibanErrorText": "Pole vyžaduje platné IBAN.",
   "uniqueErrorText": "Hodnota musí být jedinečná.",
   "bicErrorText": "Pole vyžaduje platný BIC kód.",

lib/l10n/intl_da.arb

@@ -64,6 +64,7 @@
   "containsErrorText": "Værdien skal indeholde {value}.",
   "betweenErrorText": "Værdien skal være mellem {min} og {max}.",
   "containsElementErrorText": "Værdien skal være på listen over tilladte værdier.",
+  "doesNotContainElementErrorText": "Værdien må ikke være på listen.",
   "ibanErrorText": "Dette felt kræver en gyldig IBAN.",
   "uniqueErrorText": "Dette felt skal være unikt.",
   "bicErrorText": "Dette felt kræver en gyldig BIC.",