bond_form 是一个用于简化 Flutter 表单处理的插件，它可以帮助开发者更轻松地管理表单状态、验证和提交。bond_form 提供了一种声明式的方式来定义表单字段、验证规则和提交逻辑。

以下是 bond_form 的基本使用步骤：

1. 添加依赖

首先，在 pubspec.yaml 文件中添加 bond_form 的依赖：

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

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

2. 创建表单模型

使用 bond_form 时，首先需要定义一个表单模型。这个模型将包含表单字段、验证规则和提交逻辑。

import 'package:bond_form/bond_form.dart';

class LoginForm extends FormModel {
  final email = TextField(
    name: 'email',
    rules: [
      RequiredRule('Email is required'),
      EmailRule('Invalid email format'),
    ],
  );

  final password = TextField(
    name: 'password',
    rules: [
      RequiredRule('Password is required'),
      MinLengthRule(6, 'Password must be at least 6 characters'),
    ],
  );

  @override
  List<FormField> get fields => [email, password];

  Future<void> submit() async {
    if (validate()) {
      // 表单验证通过，执行提交逻辑
      print('Email: ${email.value}');
      print('Password: ${password.value}');
      // 这里可以调用 API 或其他业务逻辑
    }
  }
}

3. 在 UI 中使用表单

在 Flutter 的 UI 中，可以使用 FormBuilder 和 FormModel 来构建表单。

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

class LoginPage extends StatefulWidget {
  @override
  _LoginPageState createState() => _LoginPageState();
}

class _LoginPageState extends State<LoginPage> {
  final _form = LoginForm();

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Login'),
      ),
      body: Padding(
        padding: const EdgeInsets.all(16.0),
        child: FormBuilder(
          form: _form,
          child: Column(
            children: [
              TextFormField(
                decoration: InputDecoration(labelText: 'Email'),
                onChanged: _form.email.setValue,
                validator: _form.email.validate,
              ),
              SizedBox(height: 16),
              TextFormField(
                decoration: InputDecoration(labelText: 'Password'),
                obscureText: true,
                onChanged: _form.password.setValue,
                validator: _form.password.validate,
              ),
              SizedBox(height: 32),
              ElevatedButton(
                onPressed: _form.submit,
                child: Text('Login'),
              ),
            ],
          ),
        ),
      ),
    );
  }
}

4. 表单验证与提交

在 LoginForm 中，validate() 方法用于验证所有字段。如果所有字段都通过验证，submit() 方法将会执行提交逻辑。

5. 自定义验证规则

bond_form 允许你自定义验证规则。你可以通过继承 Rule 类来实现自定义规则。

class CustomRule extends Rule {
  CustomRule(String message) : super(message);

  @override
  bool validate(String value) {
    // 自定义验证逻辑
    return value.contains('custom');
  }
}

6. 表单字段类型

bond_form 支持多种表单字段类型，如 TextField、NumberField、DateField 等。你可以根据需求选择合适的字段类型。

7. 表单状态管理

bond_form 还提供了表单状态管理功能，你可以监听表单的状态变化，如字段值变化、验证状态变化等。

_form.email.addListener(() {
  print('Email changed: ${_form.email.value}');
});