在Flutter中，form_bloc 是一个强大的库，用于管理表单状态和业务逻辑。它基于 BLoC（Business Logic Component）架构模式，使得表单状态管理更加清晰和可维护。下面是一个简单的示例，展示了如何使用 form_bloc 来管理一个登录表单。

首先，确保你已经在 pubspec.yaml 文件中添加了 form_bloc 依赖：

dependencies:
  flutter:
    sdk: flutter
  form_bloc: ^x.y.z  # 请替换为最新版本号

然后运行 flutter pub get 来获取依赖。

1. 定义表单字段和表单状态

首先，我们需要定义表单字段和表单状态。在这个例子中，我们有一个登录表单，包含用户名和密码字段。

import 'package:form_bloc/form_bloc.dart';

// 定义表单字段
class LoginFormFields extends FormFields<LoginFormState> {
  @override
  List<FormField<LoginFormState>> get fields => [
        FormField<LoginFormState>(
          name: 'username',
          validator: (state) {
            if (state.username!.isEmpty) {
              return 'Username is required';
            }
            return null;
          },
          builder: (state, _) => TextFormField(
            initialValue: state.username,
            decoration: InputDecoration(labelText: 'Username'),
            onChanged: (value) => context.read<FormBloc>().change(LoginFormState(username: value, password: state.password)),
          ),
        ),
        FormField<LoginFormState>(
          name: 'password',
          validator: (state) {
            if (state.password!.isEmpty) {
              return 'Password is required';
            }
            return null;
          },
          obscureText: true,
          builder: (state, _) => TextFormField(
            initialValue: state.password,
            decoration: InputDecoration(labelText: 'Password'),
            onChanged: (value) => context.read<FormBloc>().change(LoginFormState(username: state.username, password: value)),
          ),
        ),
      ];
}

// 定义表单状态
class LoginFormState extends Equatable {
  final String? username;
  final String? password;

  LoginFormState({this.username, this.password});

  @override
  List<Object?> get props => [username, password];
}

2. 创建 FormBloc

接下来，我们需要创建一个 FormBloc 来管理表单状态。

import 'package:bloc/bloc.dart';
import 'package:form_bloc/form_bloc.dart';

class LoginFormBloc extends FormBloc<LoginFormState> {
  LoginFormBloc() : super(LoginFormFields(), LoginFormState());

  @override
  Stream<FormBlocState<LoginFormState>> onSubmit() async* {
    if (state.isValid) {
      // 在这里处理表单提交，例如发送登录请求
      yield FormBlocState.submissionSuccess(state);
    } else {
      yield FormBlocState.submissionFailure(state);
    }
  }
}

3. 使用 FormBloc 在 UI 中显示表单

最后，我们在 Flutter UI 中使用 FormBlocBuilder 来构建表单。

import 'package:flutter/material.dart';
import 'package:flutter_bloc/flutter_bloc.dart';
import 'package:form_bloc/form_bloc.dart';
import 'login_form_bloc.dart'; // 假设这个文件包含上面的 LoginFormBloc 和 LoginFormFields 定义

void main() {
  runApp(BlocProvider<LoginFormBloc>(
    create: (_) => LoginFormBloc(),
    child: MyApp(),
  ));
}

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(title: Text('Login Form')),
        body: Padding(
          padding: const EdgeInsets.all(16.0),
          child: FormBlocListener<LoginFormBloc, LoginFormState>(
            listener: (context, state) {
              if (state is FormBlocStateSubmissionSuccess<LoginFormState>) {
                ScaffoldMessenger.of(context).showSnackBar(SnackBar(content: Text('Login successful')));
              } else if (state is FormBlocStateSubmissionFailure<LoginFormState>) {
                ScaffoldMessenger.of(context).showSnackBar(SnackBar(content: Text('Login failed')));
              }
            },
            child: FormBlocBuilder<LoginFormBloc, LoginFormState>(
              builder: (context, state) {
                return Column(
                  children: [
                    ...state.fields,
                    SizedBox(height: 24),
                    ElevatedButton(
                      onPressed: state.isSubmissionInProgress
                          ? null
                          : () => context.read<LoginFormBloc>().submit(),
                      child: Text('Login'),
                    ),
                  ],
                );
              },
            ),
          ),
        ),
      ),
    );
  }
}

在这个示例中，我们创建了一个简单的登录表单，并使用 form_bloc 来管理表单状态。当用户提交表单时，会根据表单的有效性显示相应的提示信息。

这个示例展示了 form_bloc 的基本用法，但 form_bloc 还支持更多高级功能，如动态字段、异步验证等，你可以根据需求进一步扩展。