simple_form_field_validator 是一个用于简化 Flutter 表单验证的插件。它提供了一种简单的方式来验证表单字段，并且可以轻松地集成到现有的 Flutter 表单中。

安装

首先，你需要在 pubspec.yaml 文件中添加依赖：

dependencies:
  flutter:
    sdk: flutter
  simple_form_field_validator: ^1.0.0

然后运行 flutter pub get 来安装依赖。

使用步骤

1. 导入包

import 'package:simple_form_field_validator/simple_form_field_validator.dart';

2. 创建表单

在 Flutter 中，你通常会使用 Form 和 TextFormField 来创建表单。你可以使用 SimpleFormFieldValidator 来简化验证逻辑。

class MyForm extends StatefulWidget {
  [@override](/user/override)
  _MyFormState createState() => _MyFormState();
}

class _MyFormState extends State<MyForm> {
  final _formKey = GlobalKey<FormState>();
  final _emailController = TextEditingController();
  final _passwordController = TextEditingController();

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Form(
      key: _formKey,
      child: Column(
        children: <Widget>[
          TextFormField(
            controller: _emailController,
            decoration: InputDecoration(labelText: 'Email'),
            validator: SimpleFormFieldValidator.email(),
          ),
          TextFormField(
            controller: _passwordController,
            decoration: InputDecoration(labelText: 'Password'),
            obscureText: true,
            validator: SimpleFormFieldValidator.password(),
          ),
          ElevatedButton(
            onPressed: () {
              if (_formKey.currentState!.validate()) {
                // 表单验证通过，执行提交操作
                print('Form is valid');
              }
            },
            child: Text('Submit'),
          ),
        ],
      ),
    );
  }
}

3. 验证规则

SimpleFormFieldValidator 提供了一些常用的验证规则，例如：

• email(): 验证电子邮件地址。
• password(): 验证密码（默认至少 6 个字符）。
• required(): 验证字段是否为空。
• minLength(int minLength): 验证字段的最小长度。
• maxLength(int maxLength): 验证字段的最大长度。
• match(String valueToMatch): 验证字段是否与指定值匹配。

你也可以自定义验证规则：

validator: (value) {
  return SimpleFormFieldValidator.custom(
    value,
    (val) {
      if (val == null || val.isEmpty) {
        return 'This field is required';
      }
      if (val.length < 5) {
        return 'Must be at least 5 characters';
      }
      return null;
    },
  );
}

示例

以下是一个完整的示例，展示了如何使用 simple_form_field_validator：

import 'package:flutter/material.dart';
import 'package:simple_form_field_validator/simple_form_field_validator.dart';

void main() {
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(title: Text('Simple Form Validator Example')),
        body: Padding(
          padding: const EdgeInsets.all(16.0),
          child: MyForm(),
        ),
      ),
    );
  }
}

class MyForm extends StatefulWidget {
  [@override](/user/override)
  _MyFormState createState() => _MyFormState();
}

class _MyFormState extends State<MyForm> {
  final _formKey = GlobalKey<FormState>();
  final _emailController = TextEditingController();
  final _passwordController = TextEditingController();

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Form(
      key: _formKey,
      child: Column(
        children: <Widget>[
          TextFormField(
            controller: _emailController,
            decoration: InputDecoration(labelText: 'Email'),
            validator: SimpleFormFieldValidator.email(),
          ),
          TextFormField(
            controller: _passwordController,
            decoration: InputDecoration(labelText: 'Password'),
            obscureText: true,
            validator: SimpleFormFieldValidator.password(),
          ),
          ElevatedButton(
            onPressed: () {
              if (_formKey.currentState!.validate()) {
                // 表单验证通过，执行提交操作
                print('Form is valid');
              }
            },
            child: Text('Submit'),
          ),
        ],
      ),
    );
  }
}