form_stream_handler 是一个用于处理 Flutter 表单数据流的插件，它可以帮助你更轻松地管理和验证表单数据。通过使用 form_stream_handler，你可以将表单字段的值、验证状态和提交状态通过流（Stream）进行管理，从而实现更灵活的表单处理逻辑。

安装

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

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

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

基本用法

1. 创建表单处理器

首先，你需要创建一个 FormStreamHandler 实例来管理表单数据流。

import 'package:form_stream_handler/form_stream_handler.dart';

final formHandler = FormStreamHandler();

2. 添加表单字段

你可以通过 addField 方法向表单处理器中添加字段。每个字段都需要一个唯一的键（key）和一个验证器（validator）。

formHandler.addField(
  'username',
  validator: (value) {
    if (value.isEmpty) {
      return 'Username is required';
    }
    return null;
  },
);

formHandler.addField(
  'password',
  validator: (value) {
    if (value.isEmpty) {
      return 'Password is required';
    }
    if (value.length < 6) {
      return 'Password must be at least 6 characters';
    }
    return null;
  },
);

3. 监听表单字段的值和验证状态

你可以通过 valueStream 和 errorStream 来监听表单字段的值和验证状态。

formHandler.valueStream('username').listen((value) {
  print('Username value: $value');
});

formHandler.errorStream('username').listen((error) {
  print('Username error: $error');
});

4. 更新表单字段的值

你可以通过 updateValue 方法来更新表单字段的值。

formHandler.updateValue('username', 'john_doe');

5. 提交表单

你可以通过 submit 方法来提交表单。submit 方法会返回一个 Future，表示表单提交的结果。

formHandler.submit().then((result) {
  if (result.isValid) {
    print('Form submitted successfully');
    print('Form data: ${result.data}');
  } else {
    print('Form has errors');
  }
});

完整示例

以下是一个完整的示例，展示了如何使用 form_stream_handler 来处理表单数据流。

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

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

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(title: Text('Form Stream Handler Example')),
        body: FormExample(),
      ),
    );
  }
}

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

class _FormExampleState extends State<FormExample> {
  final formHandler = FormStreamHandler();

  [@override](/user/override)
  void initState() {
    super.initState();

    formHandler.addField(
      'username',
      validator: (value) {
        if (value.isEmpty) {
          return 'Username is required';
        }
        return null;
      },
    );

    formHandler.addField(
      'password',
      validator: (value) {
        if (value.isEmpty) {
          return 'Password is required';
        }
        if (value.length < 6) {
          return 'Password must be at least 6 characters';
        }
        return null;
      },
    );
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Padding(
      padding: const EdgeInsets.all(16.0),
      child: Column(
        children: [
          StreamBuilder<String>(
            stream: formHandler.valueStream('username'),
            builder: (context, snapshot) {
              return TextField(
                decoration: InputDecoration(
                  labelText: 'Username',
                  errorText: formHandler.errorStream('username').value,
                ),
                onChanged: (value) {
                  formHandler.updateValue('username', value);
                },
              );
            },
          ),
          SizedBox(height: 16.0),
          StreamBuilder<String>(
            stream: formHandler.valueStream('password'),
            builder: (context, snapshot) {
              return TextField(
                obscureText: true,
                decoration: InputDecoration(
                  labelText: 'Password',
                  errorText: formHandler.errorStream('password').value,
                ),
                onChanged: (value) {
                  formHandler.updateValue('password', value);
                },
              );
            },
          ),
          SizedBox(height: 16.0),
          ElevatedButton(
            onPressed: () {
              formHandler.submit().then((result) {
                if (result.isValid) {
                  print('Form submitted successfully');
                  print('Form data: ${result.data}');
                } else {
                  print('Form has errors');
                }
              });
            },
            child: Text('Submit'),
          ),
        ],
      ),
    );
  }
}