slapp_dforms 是一个用于在 Flutter 中构建表单的插件。它提供了一种简单且灵活的方式来创建和管理表单，支持各种类型的表单字段，如文本输入、选择器、日期选择器等。以下是如何使用 slapp_dforms 插件来构建表单的基本步骤。

1. 添加依赖

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

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

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

2. 导入包

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

import 'package:slapp_dforms/slapp_dforms.dart';

3. 创建表单

使用 DForm 组件来创建一个表单。你可以通过 DFormField 来添加各种表单字段。

class MyForm extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('My Form'),
      ),
      body: Padding(
        padding: const EdgeInsets.all(16.0),
        child: DForm(
          fields: [
            DFormField(
              type: DFormFieldType.text,
              label: 'Name',
              hint: 'Enter your name',
              validator: (value) {
                if (value.isEmpty) {
                  return 'Please enter your name';
                }
                return null;
              },
            ),
            DFormField(
              type: DFormFieldType.email,
              label: 'Email',
              hint: 'Enter your email',
              validator: (value) {
                if (value.isEmpty) {
                  return 'Please enter your email';
                }
                if (!value.contains('@')) {
                  return 'Please enter a valid email';
                }
                return null;
              },
            ),
            DFormField(
              type: DFormFieldType.password,
              label: 'Password',
              hint: 'Enter your password',
              validator: (value) {
                if (value.isEmpty) {
                  return 'Please enter your password';
                }
                if (value.length < 6) {
                  return 'Password must be at least 6 characters';
                }
                return null;
              },
            ),
            DFormField(
              type: DFormFieldType.date,
              label: 'Date of Birth',
              hint: 'Select your date of birth',
              validator: (value) {
                if (value.isEmpty) {
                  return 'Please select your date of birth';
                }
                return null;
              },
            ),
          ],
          onSubmit: (values) {
            // Handle form submission
            print('Form submitted with values: $values');
          },
        ),
      ),
    );
  }
}

4. 处理表单提交

在 onSubmit 回调中，你可以处理表单提交的逻辑。values 参数是一个包含所有表单字段值的 Map。

onSubmit: (values) {
  // Handle form submission
  print('Form submitted with values: $values');
},

5. 表单验证

每个 DFormField 都可以通过 validator 属性来定义验证逻辑。如果验证失败，返回一个错误消息；如果验证成功，返回 null。

validator: (value) {
  if (value.isEmpty) {
    return 'Please enter your name';
  }
  return null;
},

6. 自定义表单字段

slapp_dforms 支持多种类型的表单字段，如文本、电子邮件、密码、日期等。你可以通过 type 属性来指定字段类型。

DFormField(
  type: DFormFieldType.text,
  label: 'Name',
  hint: 'Enter your name',
),

7. 运行应用

现在你可以运行你的 Flutter 应用，并查看 slapp_dforms 表单的效果。

flutter run