nex_validation 是一个用于 Flutter 的表单验证插件，它可以帮助开发者轻松地实现表单字段的验证。以下是如何使用 nex_validation 插件的基本步骤：

1. 添加依赖

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

dependencies:
  flutter:
    sdk: flutter
  nex_validation: ^1.0.0  # 请使用最新版本

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

2. 导入包

在你的 Dart 文件中导入 nex_validation 包：

import 'package:nex_validation/nex_validation.dart';

3. 创建表单

接下来，你可以创建一个表单，并使用 NexValidation 来验证表单字段。

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: [
          TextFormField(
            controller: _emailController,
            decoration: InputDecoration(labelText: 'Email'),
            validator: (value) => NexValidation.email(value),
          ),
          TextFormField(
            controller: _passwordController,
            decoration: InputDecoration(labelText: 'Password'),
            obscureText: true,
            validator: (value) => NexValidation.required(value),
          ),
          ElevatedButton(
            onPressed: () {
              if (_formKey.currentState!.validate()) {
                // 表单验证通过，执行提交操作
                print('Form is valid');
              }
            },
            child: Text('Submit'),
          ),
        ],
      ),
    );
  }
}

4. 使用验证规则

nex_validation 提供了多种内置的验证规则，例如：

• NexValidation.required: 验证字段是否为空。
• NexValidation.email: 验证字段是否为有效的电子邮件地址。
• NexValidation.minLength: 验证字段的最小长度。
• NexValidation.maxLength: 验证字段的最大长度。
• NexValidation.match: 验证两个字段是否匹配。

你可以根据需要选择合适的验证规则。

5. 自定义验证规则

如果你需要自定义验证规则，可以使用 NexValidation.custom 方法：

validator: (value) => NexValidation.custom(
  value,
  (value) {
    if (value!.length < 6) {
      return 'Password must be at least 6 characters long';
    }
    return null;
  },
),

6. 处理表单提交

在表单提交时，调用 _formKey.currentState!.validate() 来验证所有字段。如果所有字段都通过验证，validate() 方法将返回 true，否则返回 false。

7. 清理资源

在 dispose 方法中清理 TextEditingController：

[@override](/user/override)
void dispose() {
  _emailController.dispose();
  _passwordController.dispose();
  super.dispose();
}

完整示例

以下是一个完整的示例，展示了如何使用 nex_validation 插件进行表单验证：

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

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

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(title: Text('Nex Validation Example')),
        body: 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: Padding(
        padding: const EdgeInsets.all(16.0),
        child: Column(
          children: [
            TextFormField(
              controller: _emailController,
              decoration: InputDecoration(labelText: 'Email'),
              validator: (value) => NexValidation.email(value),
            ),
            TextFormField(
              controller: _passwordController,
              decoration: InputDecoration(labelText: 'Password'),
              obscureText: true,
              validator: (value) => NexValidation.required(value),
            ),
            SizedBox(height: 20),
            ElevatedButton(
              onPressed: () {
                if (_formKey.currentState!.validate()) {
                  // 表单验证通过，执行提交操作
                  print('Form is valid');
                }
              },
              child: Text('Submit'),
            ),
          ],
        ),
      ),
    );
  }

  [@override](/user/override)
  void dispose() {
    _emailController.dispose();
    _passwordController.dispose();
    super.dispose();
  }
}