Flutter验证码输入插件reactive_pin_code_fields的使用

reactive_pin_code_fields 是一个围绕 pin_code_fields 的包装器，用于与 reactive_forms 一起使用。

目前文档还在编写中。你可以查看 示例文件夹 获取示例代码。

示例代码

以下是一个完整的示例代码，展示了如何在 Flutter 应用程序中使用 reactive_pin_code_fields 插件。

import 'package:flutter/material.dart';
import 'package:reactive_forms/reactive_forms.dart';
import 'package:reactive_pin_code_fields/reactive_pin_code_fields.dart';

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

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  // 构建表单
  FormGroup buildForm() => fb.group({
        'input': FormControl<String>(value: null),
      });

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      theme: ThemeData(
        primarySwatch: Colors.blue,
        visualDensity: VisualDensity.adaptivePlatformDensity,
      ),
      home: Scaffold(
        appBar: AppBar(),
        body: SafeArea(
          child: SingleChildScrollView(
            physics: const BouncingScrollPhysics(),
            padding: const EdgeInsets.symmetric(
              horizontal: 20.0,
              vertical: 20.0,
            ),
            child: ReactiveFormBuilder(
              form: buildForm,
              builder: (context, form, child) {
                return Column(
                  children: [
                    // 使用ReactivePinCodeTextField构建验证码输入框
                    ReactivePinCodeTextField<String>(
                      formControlName: 'input', // 绑定到表单控件
                      length: 5, // 验证码长度为5
                    ),
                    const SizedBox(height: 16), // 添加间距
                    ElevatedButton(
                      child: const Text('Sign Up'), // 按钮文本
                      onPressed: () {
                        if (form.valid) {
                          // 如果表单验证通过，打印表单值
                          print(form.value);
                        } else {
                          // 否则标记所有控件为已触碰
                          form.markAllAsTouched();
                        }
                      },
                    ),
                  ],
                );
              },
            ),
          ),
        ),
      ),
    );
  }
}

代码说明

1. 导入必要的库

   import 'package:flutter/material.dart';
   import 'package:reactive_forms/reactive_forms.dart';
   import 'package:reactive_pin_code_fields/reactive_pin_code_fields.dart';
   

2. 主函数

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

3. 构建表单

   FormGroup buildForm() => fb.group({
         'input': FormControl<String>(value: null),
       });
   

   这里定义了一个表单，并且创建了一个名为 input 的控件，类型为 FormControl<String>。

4. 构建应用程序

   class MyApp extends StatelessWidget {
     const MyApp({super.key});
   
     @override
     Widget build(BuildContext context) {
       return MaterialApp(
         theme: ThemeData(
           primarySwatch: Colors.blue,
           visualDensity: VisualDensity.adaptivePlatformDensity,
         ),
         home: Scaffold(
           appBar: AppBar(),
           body: SafeArea(
             child: SingleChildScrollView(
               physics: const BouncingScrollPhysics(),
               padding: const EdgeInsets.symmetric(
                 horizontal: 20.0,
                 vertical: 20.0,
               ),
               child: ReactiveFormBuilder(
                 form: buildForm,
                 builder: (context, form, child) {
                   return Column(
                     children: [
                       // 使用ReactivePinCodeTextField构建验证码输入框
                       ReactivePinCodeTextField<String>(
                         formControlName: 'input', // 绑定到表单控件
                         length: 5, // 验证码长度为5
                       ),
                       const SizedBox(height: 16), // 添加间距
                       ElevatedButton(
                         child: const Text('Sign Up'), // 按钮文本
                         onPressed: () {
                           if (form.valid) {
                             // 如果表单验证通过，打印表单值
                             print(form.value);
                           } else {
                             // 否则标记所有控件为已触碰
                             form.markAllAsTouched();
                           }
                         },
                       ),
                     ],
                   );
                 },
               ),
             ),
           ),
         ),
       );
     }
   }