Flutter验证插件validasi的功能使用

validasi 是一个用于 Flutter 的表单验证插件，它可以帮助开发者轻松地对表单字段进行验证。虽然 Flutter 本身已经提供了 Form 和 TextFormField 等组件来进行表单验证，但 validasi 插件提供了一些额外的功能和便捷的验证规则，使得表单验证更加简单和高效。

安装 validasi 插件

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

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

然后运行 flutter pub get 来安装插件。

使用 validasi 插件

1. 导入 validasi 插件

import 'package:validasi/validasi.dart';

2. 创建表单并应用验证规则

validasi 插件提供了一些内置的验证规则，例如 RequiredValidator、EmailValidator、MinLengthValidator 等。你可以将这些验证器应用到 TextFormField 或其他输入组件上。

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

class MyForm extends StatefulWidget {
  @override
  _MyFormState createState() => _MyFormState();
}

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

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Validasi Example'),
      ),
      body: Padding(
        padding: const EdgeInsets.all(16.0),
        child: Form(
          key: _formKey,
          child: Column(
            children: [
              TextFormField(
                controller: _emailController,
                decoration: InputDecoration(labelText: 'Email'),
                validator: Validasi.compose([
                  RequiredValidator(errorText: 'Email is required'),
                  EmailValidator(errorText: 'Invalid email address'),
                ]),
              ),
              SizedBox(height: 16),
              TextFormField(
                controller: _passwordController,
                decoration: InputDecoration(labelText: 'Password'),
                obscureText: true,
                validator: Validasi.compose([
                  RequiredValidator(errorText: 'Password is required'),
                  MinLengthValidator(6, errorText: 'Password must be at least 6 characters'),
                ]),
              ),
              SizedBox(height: 24),
              ElevatedButton(
                onPressed: () {
                  if (_formKey.currentState!.validate()) {
                    // Form is valid, proceed with the action
                    print('Form is valid');
                  }
                },
                child: Text('Submit'),
              ),
            ],
          ),
        ),
      ),
    );
  }
}

3. 自定义验证规则

你也可以创建自定义的验证规则。只需继承 Validator 类并实现 validate 方法。

class CustomValidator extends Validator {
  @override
  String? validate(String? value) {
    if (value == null || value.isEmpty) {
      return 'This field is required';
    }
    if (value.length < 5) {
      return 'Field must be at least 5 characters';
    }
    return null;
  }
}

然后在表单中使用它：

TextFormField(
  decoration: InputDecoration(labelText: 'Custom Field'),
  validator: CustomValidator().validate,
),

4. 使用 Validasi.compose

Validasi.compose 方法允许你将多个验证器组合在一起。它会依次执行每个验证器，并在遇到第一个错误时返回错误信息。

validator: Validasi.compose([
  RequiredValidator(errorText: 'This field is required'),
  MinLengthValidator(5, errorText: 'Must be at least 5 characters'),
  CustomValidator(),
]),