flutter_form_validation #

A collection of reusable form widgets for Flutter.

Features #

✅ ValidatedTextField #

TextFormField with built-in validators and presets:

// Email — format validation built-in
ValidatedTextField.email(controller: emailC, label: 'Email');

// Password — min length + visibility toggle
ValidatedTextField.password(controller: passC, label: 'Password');

// Phone — Indonesian format (08xx...)
ValidatedTextField.phone(controller: phoneC, label: 'No. Telepon');

// Name — capitalisation + required
ValidatedTextField.name(controller: nameC, label: 'Nama Lengkap');

// Custom — multiple validators
ValidatedTextField(
  controller: codeC,
  label: 'Kode Unik',
  validators: const [
    RequiredValidator(),
    MinLengthValidator(4),
    PatternValidator(r'^[A-Z0-9]+$'),
  ],
);

✅ Built-in Validators #

✅ LoadingButton #

Button dengan loading spinner, success state, dan error message:

LoadingButton(
  isLoading: isLoading,
  label: 'Login',
  onPressed: _submit,
  errorMessage: errorMessage,  // Auto-shown below button
);

Getting started #

dependencies:
  flutter_form_validation: ^0.1.0

flutter pub get

Usage #

Basic form #

class LoginForm extends StatefulWidget {
  @override
  State<LoginForm> createState() => _LoginFormState();
}

class _LoginFormState extends State<LoginForm> {
  final _formKey = GlobalKey<FormState>();
  final _emailC = TextEditingController();
  final _passC = TextEditingController();
  bool _isLoading = false;
  String? _error;

  Future<void> _submit() async {
    if (!_formKey.currentState!.validate()) return;
    setState(() => _isLoading = true);
    try {
      await authService.login(_emailC.text, _passC.text);
    } catch (e) {
      setState(() => _error = e.toString());
    } finally {
      setState(() => _isLoading = false);
    }
  }

  @override
  Widget build(BuildContext context) {
    return Form(
      key: _formKey,
      child: Column(
        children: [
          ValidatedTextField.email(controller: _emailC),
          const SizedBox(height: 16),
          ValidatedTextField.password(controller: _passC),
          const SizedBox(height: 24),
          LoadingButton(
            isLoading: _isLoading,
            label: 'Login',
            onPressed: _submit,
            errorMessage: _error,
          ),
        ],
      ),
    );
  }
}

API #

ValidatedTextField #

LoadingButton #

License #

MIT