reform 0.2.0

Pure dart form validation and sanitization, built with Flutter in mind

Pure dart form validation and sanitization

Validation

You could use validate extensions method on any value to convert it to validatable field:

Validation is identical to Flutter concept: if value is valid, validator should return null. Otherwise - error text:

final refield = "@my_username".validate(
  (v) => v.length >= 10 
    ? null 
    : "Username should be at least 10 characters"
);

refield.displayError // Username should be at least 10 characters
refield.isValid // false
refield.value // @my_username

Sanitization

Sanitization comes in handy, when you apply formatting to your fields:

/// Note: `normalizerFunction` and `phoneValidatorFunction` are user-defined functions. 
/// You could code your own or use package from pub.dev
final phoneField = "[phone]"
  .sanitize((v) => normalizerFunction(v))
  .validate((v) => phoneValidatorFunction());

phoneField.originalValue // [phone]
phoneField.sanitizedValue // [phone]
phoneField.isValid // true

If validation fails, sanitized value cannot be retrieved:

phoneField.isValid // false
phoneField.originalValue // [phone]
phoneField.sanitizedValue // throws StateError

Reform utility class

There is a convinience class to validate several fields:

final isFormValid = Reform.isValid([firstNameField, lastNameField, emailField]); 

isFormValid // true

Also, there is isEnabled method:

final isEnabled = Reform.isEnabled([firstNameField, lastNameField, emailField]); 

isFormEnabled // true

If isEnabled == true user can click on the submission button. If isValid == true you can send your form to your server.