Flutter泰国身份证号验证插件thai_id_card_numbers的使用

Flutter泰国身份证号验证插件thai_id_card_numbers的使用

简介

thai_id_card_numbers 是一个Flutter插件，用于在用户输入时验证和格式化泰国身份证号码。该插件可以帮助开发者轻松实现泰国身份证号码的验证功能，并且提供了生成随机有效身份证号码的功能。

使用方法

要使用此插件，请按照以下步骤操作：

1. 添加依赖
   在 pubspec.yaml 文件中添加 thai_id_card_numbers 作为依赖项：

   dependencies:
     flutter:
       sdk: flutter
     thai_id_card_numbers: ^latest_version  # 请替换为最新版本号
   

2. 导入包
   在 Dart 文件中导入 thai_id_card_numbers 包：

   import 'package:thai_id_card_numbers/thai_id_card_numbers.dart';
   import 'package:thai_id_card_numbers/thai_id_card_numbers_formatter.dart';
   

3. 创建示例应用
   下面是一个完整的示例代码，展示了如何使用 thai_id_card_numbers 插件来验证和格式化泰国身份证号码。

完整示例代码

import 'package:flutter/material.dart';
import 'package:thai_id_card_numbers/thai_id_card_numbers.dart';
import 'package:thai_id_card_numbers/thai_id_card_numbers_formatter.dart';

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

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

  [@override](/user/override)
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  final _thaiIdCardNumbers = ThaiIdCardNumbers();  // 创建 ThaiIdCardNumbers 实例
  final _formKey = GlobalKey<FormState>();  // 用于表单验证
  final _messengerKey = GlobalKey<ScaffoldMessengerState>();  // 用于显示消息
  late TextEditingController _textEditingController;  // 文本控制器

  [@override](/user/override)
  void initState() {
    super.initState();
    _textEditingController = TextEditingController();  // 初始化文本控制器
  }

  [@override](/user/override)
  void dispose() {
    _textEditingController.dispose();  // 释放资源
    super.dispose();
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    // 定义身份证号码的格式模式和分隔符
    String pattern = "x-xxxx-xxxxx-xx-x";
    String separator = "-";

    return MaterialApp(
      scaffoldMessengerKey: _messengerKey,  // 设置全局消息键
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Thai ID Card Number Validator Demo'),  // 应用标题
        ),
        body: Padding(
          padding: const EdgeInsets.all(20.0),  // 内边距
          child: Form(
            key: _formKey,  // 表单键
            child: Column(
              children: [
                const Padding(
                  padding: EdgeInsets.all(20.0),
                  child: Text('Enter your Thai ID card numbers'),  // 提示文本
                ),
                TextFormField(
                  controller: _textEditingController,  // 绑定文本控制器
                  validator: (String? value) {  // 验证器
                    String? newValue = value?.replaceAll(RegExp('-'), '');  // 移除所有分隔符
                    if (!_thaiIdCardNumbers.validate(newValue!)) {  // 验证身份证号码
                      return "$value is not a valid Thai ID card numbers.";  // 返回错误信息
                    }
                    return null;  // 验证通过
                  },
                  inputFormatters: [
                    ThaiIdCardNumbersFormatter(
                        pattern: pattern, delimiter: separator),  // 格式化输入
                  ],
                  decoration: const InputDecoration(
                    hintText: "1-2345-67891-01-2",  // 输入提示
                    border: OutlineInputBorder(),  // 边框样式
                    focusedBorder: OutlineInputBorder(
                      borderSide: BorderSide(width: 1, color: Colors.blueAccent),  // 聚焦时的边框样式
                    ),
                  ),
                ),
                const SizedBox(height: 10.0),  // 间距
                Row(
                  mainAxisAlignment: MainAxisAlignment.spaceEvenly,  // 按钮居中对齐
                  children: [
                    ElevatedButton(
                      onPressed: () {
                        _textEditingController.clear();  // 清空输入框
                        _textEditingController.text = _thaiIdCardNumbers.format(_thaiIdCardNumbers.generate());  // 生成并格式化随机身份证号码
                      },
                      child: const Text("Generate"),  // 生成按钮
                    ),
                    ElevatedButton(
                      onPressed: () {
                        if (_formKey.currentState!.validate()) {  // 验证表单
                          _messengerKey.currentState?.showMaterialBanner(MaterialBanner(
                            content: const Text(
                              "Congratulations, Your Thai ID card numbers is in valid format.",  // 成功提示
                              style: TextStyle(
                                color: Colors.green,  // 文字颜色
                              ),
                            ),
                            actions: [
                              TextButton(
                                  onPressed: () {
                                    _messengerKey.currentState?.hideCurrentMaterialBanner();  // 关闭提示
                                  },
                                  child: const Text("DISMISS")),  // 关闭按钮
                            ],
                          ));
                        }
                      },
                      child: const Text("Validate"),  // 验证按钮
                    ),
                  ],
                ),
              ],
            ),
          ),
        ),
      ),
    );
  }
}