text_form_validator 1.0.4

Provides a simple way to combine validation functions, failing and providing the most informative error to the user.

Form Validator

This package is intended to help create informative validation for flutter form fields.

Features

The FormValidator class is inteneded to be used to chain validation functions together to produce one validator function as required by Widgets such as TextFormField. The final closure using the build method matches the type required by the validator attribute for form fields 'String? Function(String?)'.

Getting started

To use this pacakge add text_form_validator as a package in your pub file.

Usage

import 'package:text_form_validator/form_validator.dart';
// Basic, the field can't be null or empty
TextFormField(validator: FormValidator.required().build());

// All the messages which will be returned from validation can't be customised
// as required. Each validator is run one after the other, so the message
// to the end user can be as specific as possible
TextFormField(validator: FormValidator.builder()
    .notNull(nullError: "Woah enter something!")
    .notEmpty()
    .isNumeric()
    .build());

// More complex validation can also be added on the fly
String customErorr = "Number must be a multiple of 100!";

ValidationFn validator = FormValidator.builder()
    .notNull(nullError: "Woah enter something!")
    .notEmpty()
    .isNumeric()
    // If it hits the custom we can assume the types will convert properly
    .custom((p0) => (p0 == null || (num.parse(p0) % 100) != 0) ? customErorr : null)
    .build();

TextFormField(validator: validator);

Current Default Functions

Below is a list of all current default functions provided, as specified these are here to assist the user, and may not be exhaustive, see FormValidator.custom for adding custom functions. The descriptions provided here are breif, check the functions themselves in utils/string_validation_functions.dart for full details.

Default Functions List

• notNull: Not equal to null
• notEmpty: Not equal to ""
• required: Combines notNull and notEmpty
• isNumeric: num.tryParse != null
• isDateTime: The value can be formatted into a date (can specify custom format)
• equals: == provided value
• notEquals: != provided value
• lengthGt: value.length > providedValue
• lengthGtEq: value.length >= providedValue
• lengthLt: value.length < providedValue
• lengthLtEq: value.length <= providedValue
• lengthEq: value.length == providedValue
• inList: The value is in the provided list
• notInList: The value is not in the provided list
• matches: The value matches the supplied regex pattern
• isAnEmail: The value matches the StraingValidationFunctions.emailRegExp pattern

Additional information

The benefit of the chaining of functions allow user messages to be as customized as possible.

For StraingValidationFunctions errors are provided in line. This allows for errors like in StraingValidationFunctions.equals where it specifies the equal value in the default error.