well_formed 0.3.1

A form field package designed to relieve developers of much of the form-related coding. It provides field masking, validation, smart trimming, and more.

well_formed

Contents

• Overview
• Getting Started
• Demo application
• References

Overview

Well-Formed Widget Fields — Well-Formed is a form field package designed to relieve developers of much of the form-related coding. This is achieved by providing out-of-the-box field masking, validation, smart trimming, and more.

In addition, this package aims to:

• improve source code readability by providing form fields with "semantic" names — names that convey their purpose at first glance — such as "EmailField", "DigitField", "IntField", "Ipv4Field", and so on.
• automate the selection of the keyboard type according to the field's purpose.
• not to end up being yet another buggy Flutter form package!.

In order to be a reliable package, every class is well-documented and fully unit tested by a CI/CD pipeline with rigorous quality gates.

Getting Started

Most of the form fields in this package are built on top of the TextFormField widget so that they remain fully compatible with Flutter's Form widget. This is important to avoid erroneous (buggy) behavior, such as when a field does not reset when its parent widget is reset.

Demo application

The demo application provides a fully working example, focused on demonstrating exactly three widgets in action — WellFormed, BasicTextField and DigitField. You can take the code in this demo and experiment with it.

To run the demo application:

git clone https://github.com/dartoos-dev/well_formed.git
cd well_formed/example/
flutter run -d chrome

This should launch the demo application on Chrome in debug mode.

References

• TextFormField
• build a Flutter form
• Mozilla input types