Skip to content

zasadnyy/z-validations

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

36 Commits
 
 
 
 
 
 
 
 

Repository files navigation

z-validations

Small library that helps with Android form validations

Library was written in scope of post: Android form validation - the right way

Chuck Noris is always valid

Available validations

  • NotEmpty - checks if field is not blank
  • IsEmail - checks if field is valid email
  • IsPositiveInteger - checks if fiels value is integer and if value > 0
  • InRange - checks if field value is integer and is in range min < value < max
  • HasMinimumLength - checks if field value lenght is value.lenght >= min

You can easily create your own validations, just implement ua.org.zasadnyy.zvalidations.validation.Validation interface

Sample usage

Include into your project. If you're using gradle simply copy z-validations-library folder into your project and update your build.gradle dependencies list

    dependencies {
        compile project(':z-validations-library')
        ...
    }

Create validation form and add some validations

    Form mForm = new Form(mActivity);
    mForm.addField(Field.using(mNameEditText).validate(NotEmpty.build(mContext)));
    mForm.addField(Field.using(mEmailEditText).validate(NotEmpty.build(mContext)).validate(IsEmail.build(mContext)));
    mForm.addField(Field.using(mAgeEditText).validate(InRange.build(mContext, 0, 120)));

Check if form is valid

    private void submit() {
        if (mForm.isValid()) {
            Toast.makeText(this, "Form is valid", Toast.LENGTH_SHORT).show();
        }
    }

Since v.0.2 you can change how validation errors are displayed. Library includes error renderers using TextView errors (used by default) and Toasts. You can create your own by implementing ua.org.zasadnyy.zvalidations.ValidationFailedRenderer interface

    mForm.setValidationFailedRenderer(new TextViewValidationFailedRenderer(mContext));

Checkout sample project for full usage example or install it from Google Play

Changelog

Current version: 0.2

v.0.2.1

  • Added HasMinimumLength validation (thanks TheoTzaferis for pull request)

v.0.2

v.0.1

  • Initial release

About

Make your Android form validations easy

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •  

Languages