Formdator는 데코레이터 패턴을 사용하여 조합할 수 있는 유연한 폼 필드 검증기의 컬렉션을 제공하는 Dart 패키지입니다. 개발자가 여러 검증 규칙을 원활하게 결합할 수 있게 해주어 폼 간에 재사용 가능하고 모듈화된 검증 로직을 구현할 수 있습니다. 동적 또는 복잡한 입력 검증이 필요한 애플리케이션에 적합하며, 모바일, 웹, 데스크톱 등 다양한 플랫폼을 지원합니다. 이 패키지는 깔끔하고 조합 가능한 코드를 강조하며, Flutter 폼 생태계와 쉽게 통합됩니다.
Formdator is a fully object-oriented package for validating Flutter form fields.
Its main benefits, compared to all other similar packages, include:
Dependency-free: there is only pure Dart code.
Object-oriented mindset: the elements for validation are immutable
objects that can be combined in various configurations.
Classes with short — yet meaningful — names like Req for required fields;
ReqEmail for non-empty, well-formed emails; Len for length constraints;
Int for integer-only values; and so on.
Easy-to-compose validators: e.g., the command Trim(Email()) produces a
validator that trims an email value before validating it.
Multiple validation at once: you can apply multiple validation rules at once
by using the Pair or Rules classes.
Built-in set of compound validators: e.g., to validate an email and limit its
length to a maximum of 50 characters, simply use an instance of
Email.len(50) — write less; do more!
For easier integration with Flutter form fields, every validator implements the
call() method. As a result, any validator object can be called as a function —
Callable Classes.
Getting Started
The following code snippet demonstrates how you can easily group the Rules,
Req, Len and Email classes together to create a kind of
'email-max-50-characters' constraint.
@overrideWidgetbuild(BuildContext context) {
returnTextFormField(
validator: Rules<String>([ // The "Rules" class performs multiple validations at once.Req(blank: 'Please enter the email'), // "blank" is the error message in case of field left blank.Len.max(50, long: 'Email length cannot exceed 50 characters'), // "long" is the error message if an input value is too long.Email(mal: 'Malformed email'), // "mal" is the error message in case of malformed email.
]),
);
}
Or — even better — use the compound validator ReqEmail to perform the same
task.
logic
— validation logic and unit testing (Equal, Ok, Nok, ValueBack).
net —
internet (Email, Ipv4, Ipv6, MacAddr, Url, etc.).
numeric
— validators related to numbers or digits (Digit, Hex, Int, Num, etc.).
Demo application
The demo application provides a fully working example, focused on demonstrating
exactly four validators in action — Pair, ReqLen, ReqEmail, and Equal.
You can take the code in this demo and experiment with it.
To run the demo application:
git clone https://github.com/dartoos-dev/formdator.git
cd formdator/example/
flutter run -d chrome
This should launch the demo application on Chrome in debug mode.
Contribute
Contributors are welcome!
Open an issue regarding an improvement, a bug you noticed, or ask to be
assigned to an existing one.
If the issue is confirmed, fork the repository, do the changes on a separate
branch and make a Pull Request.
After review and acceptance, the Pull Request is merged and closed.
Make sure the command below passes before making a Pull Request.