flutter_model_form_validation 1.0.0

A new Flutter package project for model validation. Use annotation on a class to describe its rules. Make your own validators easily. This package replaces EasyValidation.

Flutter model form validation

Flutter model form validation provides many validators for Flutter, based on Dart plugin Respectable. This package replaces EasyValidation.

Get started

First, you need to add the following dependencies to your 'pubspec.yaml':

dependencies:
  reflectable: any
  build_runner: any
  flutter_model_form_validation: any

Complete list of available validators

Validator	Description	Progress
ContainsDateTime	ContainsDateTime validator permits you to check that a datetime value is into an array.	done
ContainsNumber	ContainsNumber validator permits you to check that a number value is into an array.	done
ContainsString	ContainsString validator permits you to check that a string value is into an array.	done
DateTimeRange	DateTimeRange validator permits you to check that a datetime using by declared settings.	done
Email	Email validator permits you to check that a string value is a valid email.	done
EqualToDateTime	EqualToDateTime validator permits you to check that a value is equal to the value of another property.	done
EqualToNumber	EqualToNumber validator permits you to check that a value is equal to the value of another property.	done
EqualToString	EqualToString validator permits you to check that a value is equal to the value of another property.	done
FileMimeType	FileMimeType validator permits you to check that a string value is a valid mime type.	done
FileSize	FileSize validator permits you to check that a string value is a valid size.	done
GreaterOrEqualToDateTime	GreaterOrEqualToDateTime validator permits you to check that a value is greater or equal to the value of another property.	done
GreaterOrEqualToNumber	GreaterOrEqualToNumber validator permits you to check that a value is greater or equal to the value of another property.	done
GreaterOrEqualToString	GreaterOrEqualToString validator permits you to check that a value is greater or equal to the value of another property.	done
GreaterThanDateTime	GreaterThanDateTime validator permits you to check that a value is greater than the value of another property.	done
GreaterThanNumber	GreaterThanNumber validator permits you to check that a value is greater than the value of another property.	done
GreaterThanString	GreaterThanString validator permits you to check that a value is greater than the value of another property.	done
ImageSize	ImageSize validator permits you to check that a string value is a valid image size.	done
InText	InText validator permits you to check that a string value is into a text.	done
MembershipPassword	MembershipPassword validator permits you to check that a string value is accordance with declared settings.	done
NotEqualToDateTime	NotEqualToDateTime validator permits you to check that a value is not equal to the value of another property.	done
NotEqualToNumber	NotEqualToNumber validator permits you to check that a value is not equal to the value of another property.	done
NotEqualToString	NotEqualToString validator permits you to check that a value is not equal to the value of another property.	done
NumberRange	NumberRange validator permits you to check that a number using by declared settings.	done
PhoneNumber	PhoneNumber validator permits you to check that a string value is a valid phone number.	work in progress. I need documentation about phone number formats for each country in the world.
RegularExpression	RegularExpression validator permits you to check that a string value is accordance with provided regular expression.	done
Required	Required validator permits you to check that a value is provided.	done
SmallerOrEqualToDateTime	SmallerOrEqualToDateTime validator permits you to check that a value is smaller or equal to the value of another property.	done
SmallerOrEqualToNumber	SmallerOrEqualToNumber validator permits you to check that a value is smaller or equal to the value of another property.	done
SmallerOrEqualToString	SmallerOrEqualToString validator permits you to check that a value is smaller or equal to the value of another property.	done
SmallerThanDateTime	SmallerThanDateTime validator permits you to check that a value is smaller than the value of another property.	done
SmallerThanNumber	SmallerThanNumber validator permits you to check that a value is smaller than the value of another property.	done
SmallerThanString	SmallerThanString validator permits you to check that a value is smaller than the value of another property.	done
StringLength	StringLength validator permits you to check that a string value has a length between two values.	done
StringRange	StringRange validator permits you to check that a string using by declared settings.	done
URL	URL validator permits you to check that a string value is a valid URL.	done

How to use validators and validate a model

Here is a simple usage example. Note that a lot of examples are available in unit test file test/flutter_model_form_validation_test.dart.

How to define a class model with validation:

import 'package:flutter_model_form_validation/flutter_model_form_validation.dart';

@flutterModelFormValidator
class MyModel {
  MyModel(this.firstname, this.lastname, this.gender, this.birthday, this.dateOfDeath);
  
  @Required(error: 'Firstname is required')
  @StringLength(min: 3, max: 32, error: 'Firstname must have between 3 and 32 characters')
  final String firstname;
  
  @Required(error: 'Lastname is required')
  @StringLength(min: 3, max: 32, error: 'Lastname must have between 3 and 32 characters')
  final String lastname;

  @Required(error: 'Gender is required')
  @StringLength(min: 1, max: 1, error: 'Gender must have 1 character')
  final String gender;

  @Required(error: 'Birthday is requried')
  @DateTimeRange(min: '1900-01-01', max: null, error: 'Birthday must be betwwen 1900/01/01 and infinity')
  final DateTime birthday;

  @DateTimeRange(min: '1900-01-01', max: null, error: 'DateOfDeath must be betwwen 1900/01/01 and infinity')
  @GreaterOrEqualToDateTime(propertyName: 'birthday', error: 'DateOfDeath must be greater than Birthday')
  final DateTime dateOfDeath;
}

Each time you add a validator and each time you update your model class, you must regenerate a mapping file of your models and validators. If this file is not generated and update after any change, Flutter model form validation won't work !

Use this command line to get the file to get a new file named *.reflectable.dart into a flutter package project.

> flutter packages pub run build_runner build

Use this command line to get the file to get a new file named *.reflectable.dart into a flutter application project.

> flutter pub run build_runner build

How to validate a model:

• Import the generated mapping file.
• Call initializeReflectable funtion.

import 'package:flutter_model_form_validation/flutter_model_form_validation.dart';
import 'package:*.reflectable.dart';

initializeReflectable();

MyModel tester = new MyModel('Maxime', 'AUBRY', 'M', DateTime.parse('1986-12-22'), null);
bool isValid = ModelState.isValid<MyModel>(tester);

if (isValid) {
  // do stuff...
} else {
  print(ModelState.errors);
}

Practice usage for Flutter with Blocs:

Here is the authentication_form.dart file:

class AuthenticationForm extends StatefulWidget {
  @override
  _AuthenticationFormState createState() => _AuthenticationFormState();
}

class _AuthenticationFormState extends State<AuthenticationForm> {
  final TextEditingController _emailController = TextEditingController();
  final TextEditingController _passwordController = TextEditingController();

  AuthenticationFormBloc _authenticationFormBloc;

  @override
  void initState() {
    super.initState();
    _authenticationFormBloc = BlocProvider.of<AuthenticationFormBloc>(context);
    _emailController.addListener(_onEmailChanged);
    _passwordController.addListener(_onPasswordChanged);
  }

  @override
  void dispose() {
    _emailController.dispose();
    _passwordController.dispose();
    super.dispose();
  }

  @override
  Widget build(BuildContext pageContext) {
    return MultiBlocListener(
      listeners: [
        // ...
      ],
      child: BlocBuilder<AuthenticationFormBloc, AuthenticationFormState>(
        builder: (BuildContext context, AuthenticationFormState state) {
          return Form(
            child: Padding(
              padding: EdgeInsets.all(15),
              child: Column(
                mainAxisAlignment: MainAxisAlignment.start,
                crossAxisAlignment: CrossAxisAlignment.stretch,
                children: <Widget>
                  EmailInput(controller: _emailController),
                  PasswordInput(controller: _passwordController),
                ],
              ),
            ),
          );
        },
      ),
    );
  }

  // Events
  void _onEmailChanged() {
    _authenticationFormBloc
        .dispatch(EmailChangedEvent(email: _emailController.text));
  }

  void _onPasswordChanged() {
    _authenticationFormBloc
        .dispatch(PasswordChangedEvent(password: _passwordController.text));
  }
}

Here is the email_input.dart:

class PasswordInput extends StatelessWidget {
  PasswordInput({
    @required this.controller,
  });

  final TextEditingController controller;

  @override
  Widget build(BuildContext context) {
    final AuthenticationFormBloc _authenticationFormBloc =
        BlocProvider.of<AuthenticationFormBloc>(context);

    return BlocBuilder<AuthenticationFormBloc, AuthenticationFormState>(
      bloc: _authenticationFormBloc,
      builder: (BuildContext context, AuthenticationFormState state) {
        return TextFormField(
          decoration: InputDecoration(
            icon: Icon(
              Icons.lock,
              color: Colors.grey,
            ),
            suffixIcon: IconButton(
              icon: Icon(
                Icons.info,
                color: Colors.grey,
              ),
            ),
            labelText: 'Password',
            labelStyle: TextStyle(color: Colors.grey),
          ),
          controller: controller,
          obscureText: true,
          autovalidate: true,
          autocorrect: false,
          textInputAction: TextInputAction.done,
          keyboardType: TextInputType.text,
          validator: (String value) {
            if (state.errors.containsKey('password'))
              return state.errors['password'];
            return null;
          },
        );
      },
    );
  }
}

Here is the authentication_model.dart file:

@flutterModelFormValidator
class AuthenticationModel {
  AuthenticationModel(
    this.email,
    this.password,
  );

  @Required(error: 'Email is required')
  String email;

  @Required(error: 'Password is required')
  @MembershipPassword(
      minLength: 8,
      maxLength: 16,
      includesAlphabeticalCharacters: true,
      includesUppercaseCharacters: true,
      includesNumericalCharacters: true,
      includesSpecialCharacters: true,
      error: 'Invalid password')
  String password;
}

Here is the authentication_form_bloc.dart:

class AuthenticationFormBloc
    extends Bloc<AuthenticationFormEvent, AuthenticationFormState> {
  @override
  AuthenticationFormState get initialState => AuthenticationFormState.initial();

  @override
  Stream<AuthenticationFormState> mapEventToState(
    AuthenticationFormEvent event,
  ) async* {
    if (event is PasswordChangedEvent)
      yield* _onPasswordChanged(event.password);
  }

  Stream<AuthenticationFormState> _onPasswordChanged(String password) async* {
    yield currentState.copyWith(password: password);
  }
}

Here is the authentication_form_event.dart file:

@immutable
abstract class AuthenticationFormEvent extends Equatable {
  AuthenticationFormEvent([List props = const []]) : super(props);
}

class PasswordChangedEvent extends AuthenticationFormEvent {
  final String password;

  PasswordChangedEvent({@required this.password}) : super([password]);

  @override
  String toString() => 'PasswordChangedEvent { password: $password }';
}

Here is the authentication_form_state.dart file:

import 'dart:convert';

import 'package:flutter_model_form_validation/flutter_model_form_validation.dart';
import 'package:equatable/equatable.dart';
import 'package:greenworld/main.reflectable.dart';
import 'package:greenworld/models/authentication_model.dart';
import 'package:meta/meta.dart';

@immutable
class AuthenticationFormState extends Equatable {
  final String email;
  final String password;
  final Map<String, ValidationError> errors = Map<String, ValidationError>();
  final bool isFormValid;

  AuthenticationFormState({
    @required this.email,
    @required this.password,
    Map<String, ValidationError> errors,
    @required this.isFormValid,
  }) : super([
          email,
          password,
          isFormValid,
        ]) {
    this.errors.addAll(errors);
  }

  bool _validate(AuthenticationModel model, Map<String, ValidationError> _errors) {
    initializeReflectable();
    bool _isFormValid = ModelState.isValid<AuthenticationModel>(model);

    if (_isFormValid) {
      print('form is valid');
      print(json.encode(model));
      _errors.clear();
    } else {
      print('Form is not valid');
      print(json.encode(model));
      _errors.addAll(ModelState.errors ?? Map<String, ValidationError>());
    }

    return _isFormValid;
  }

  factory AuthenticationFormState.initial() {
    return AuthenticationFormState(
      email: '',
      password: '',
      errors: Map<String, ValidationError>(),
      isFormValid: false,
    );
  }

  AuthenticationFormState copyWith({
    String email,
    String password,
    String retypePassword,
  }) {
    AuthenticationModel model = AuthenticationModel(
      email ?? this.email,
      password ?? this.password,
    );
    Map<String, ValidationError> _errors = Map<String, ValidationError>();
    bool _isFormValid = _validate(model, _errors);

    return AuthenticationFormState(
      email: email ?? this.email,
      password: password ?? this.password,
      errors: _errors,
      isFormValid: _isFormValid,
    );
  }

  @override
  String toString() {
    return '''AuthenticationFormState {
      email: $email,
      password: $password,
      errors: $errors,
      isFormValid: $isFormValid,
    }''';
  }
}

Feature requests and bug reports

Please file feature requests and bugs using the github issue tracker for this repository.