패키지, 저장소 및 앱 카테고리 검색

패키지 상세v1.1.1

formdator

조합을 통해 선택하고 다양한 조합으로 그룹화할 수 있는 폼 필드 검증기의 집합입니다 — 데코레이터 패턴.

AndroidiOSWebmacOSWindowsLinux
30일 다운로드
117
좋아요
28
Pub 점수
150

패키지 설치

flutter pub add formdator

패키지 개요

공개 정보를 바탕으로 생성한 선택 가이드입니다.

Formdator는 데코레이터 패턴을 사용하여 조합할 수 있는 유연한 폼 필드 검증기의 컬렉션을 제공하는 Dart 패키지입니다. 개발자가 여러 검증 규칙을 원활하게 결합할 수 있게 해주어 폼 간에 재사용 가능하고 모듈화된 검증 로직을 구현할 수 있습니다. 동적 또는 복잡한 입력 검증이 필요한 애플리케이션에 적합하며, 모바일, 웹, 데스크톱 등 다양한 플랫폼을 지원합니다. 이 패키지는 깔끔하고 조합 가능한 코드를 강조하며, Flutter 폼 생태계와 쉽게 통합됩니다.

사용 사례

  • 동적 폼 검증
  • 복잡한 입력 규칙
  • 재사용 가능한 검증 컴포넌트
  • 크로스 플랫폼 양식
  • 사용자 정의 검증 체인
  • 실시간 피드백

주요 기능

  • 결합 가능한 검증기
  • 데코레이터 패턴 구현
  • Platform-agnostic
  • Flutter 폼과의 간편한 통합
  • 모듈러 디자인
  • 확장 가능한 검증 로직

적합한 대상

  • 복잡한 폼을 개발하는 개발자
  • 유지보수 가능한 검증 코드가 필요한 팀
  • 다중 규칙 검증이 필요한 앱
  • 크로스 플랫폼 요구사항을 가진 Flutter 프로젝트
  • 코드 재사용을 중시하는 프로젝트

고려 사항

  • 데코레이터 패턴에 대한 이해가 필요합니다
  • 간단한 폼의 복잡성을 증가시킬 수 있음
  • 기본 예제 외에 문서가 제한적
  • 폼 위젯 내 올바른 설정에 의존

원본 README

연결된 소스 저장소의 README 원문 스냅샷입니다. 최신 내용은 저장소에서 확인하세요.

formdator

EO-Color logo

EO principles respected here DevOps By Rultor.com

pub license PDD status

build codecov CodeFactor Grade style: lint Hits-of-Code

Contents

Overview

Formdator — Formidable Validator.

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.

  @override
  Widget build(BuildContext context) {
    return TextFormField(
      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.

  @override
  Widget build(BuildContext context) {
    return TextFormField(
      validator: ReqEmail.len(
        50,
        blank: 'Please enter the email',
        mal: 'Malformed email',
        long: 'Email length cannot exceed 50 characters',
      ),
    );
  }

The shorter command ReqEmail.len(50) is equivalent to the much longer command Rules<String>([Req(), Len.max(50), Email()]) — write less; do more!

List of Validators

For a complete list of validators with detailed information about each one (constructors, parameters, etc.):

Grouped by Category
  • brazil — validators related to Brazil (BrMobile, BrPhone, Cep, Cnpj, Cpf, etc.).
  • core — core validators (Len, Match [text pattern], Pair, Req, Rules, Trim, etc.).
  • 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.

formdator-demo-app

Contribute

Contributors are welcome!

  1. Open an issue regarding an improvement, a bug you noticed, or ask to be assigned to an existing one.
  2. If the issue is confirmed, fork the repository, do the changes on a separate branch and make a Pull Request.
  3. After review and acceptance, the Pull Request is merged and closed.

Make sure the command below passes before making a Pull Request.

  dart analyze && sudo dart test

References

카테고리

소스 저장소

이 패키지를 사용하는 프로젝트