Flutter表单验证插件pars_validator的使用

Flutter表单验证插件pars_validator的使用

1. 简介

ParsValidator 是一个专为波斯语开发人员设计的健壮且轻量级的验证库，适用于Flutter应用程序。它提供了一系列工具和实用程序，用于验证特定于波斯语的数据格式，包括国家代码、电话号码、Shamsi日期、银行卡号等。

2. 功能特性

• 通用文本工具：

  • 检查文本是否仅包含波斯字母
  • 验证给定文本的单词数量
  • 统计给定文本中的单词数
  • 将文本转换为波斯格式，替换阿拉伯字符和英文数字
  • 将波斯和阿拉伯数字转换为英文数字
  • 将数字转换为波斯字母
  • 将数字转换为波斯货币（Tomans）
  • 使用自定义分隔符和分组大小分离数字和字符串
  • 验证OTP码
  • 验证密码（可自定义参数）
  • 处理半角空格

• 国家工具：

  • 验证伊朗国家身份证
  • 生成随机有效的伊朗国家身份证
  • 获取国家身份证的签发地点
  • 验证伊朗邮政编码
  • 验证伊朗公司国家身份证

• 银行工具：

  • 验证信用卡号
  • 格式化信用卡号
  • 验证IBAN（Shaba）
  • 获取卡号对应的银行名称或图标

• 电话、手机号、电子邮件工具：

  • 验证座机和手机号码格式
  • 获取座机号码对应的省份
  • 获取手机号码对应的运营商名称或图标
  • 验证标准格式的电子邮件地址

3. 平台支持

ParsValidator 支持以下平台：

• Android
• iOS
• macOS
• Web
• Linux
• Windows

4. 安装

要使用此插件，请在 pubspec.yaml 文件中添加依赖项：

dependencies:
  pars_validator: ^0.5.7

然后运行以下命令来获取包：

flutter pub get

在项目中导入包：

import 'package:pars_validator/pars_validator.dart';

5. 使用示例

5.1 基本用法

以下是一个完整的示例，展示了如何在Flutter应用程序中使用 ParsValidator 进行表单验证。

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

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

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

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Pars Validator Demo',
      theme: ThemeData(
        colorScheme: ColorScheme.fromSeed(seedColor: Colors.deepPurple),
        useMaterial3: true,
      ),
      home: const MyHomePage(title: 'Pars Validator Demo'),
    );
  }
}

class MyHomePage extends StatefulWidget {
  const MyHomePage({super.key, required this.title});

  final String title;

  [@override](/user/override)
  State<MyHomePage> createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  // 定义控制器
  final TextEditingController _nationalIdController = TextEditingController();
  final TextEditingController _cardNumberController = TextEditingController();
  final TextEditingController _mobileNumberController = TextEditingController();
  final TextEditingController _emailController = TextEditingController();

  // 定义错误信息
  String? _nationalIdError;
  String? _cardNumberError;
  String? _mobileNumberError;
  String? _emailError;

  // 验证函数
  void _validateForm() {
    setState(() {
      // 清除之前的错误信息
      _nationalIdError = null;
      _cardNumberError = null;
      _mobileNumberError = null;
      _emailError = null;

      // 验证国家身份证
      if (!National.isNationalIDValid(_nationalIdController.text)) {
        _nationalIdError = '无效的国家身份证号';
      }

      // 验证信用卡号
      if (!Banker.isCardNumberValid(_cardNumberController.text)) {
        _cardNumberError = '无效的信用卡号';
      }

      // 验证手机号
      if (!Phone.isMobileNumberValid(_mobileNumberController.text)) {
        _mobileNumberError = '无效的手机号';
      }

      // 验证电子邮件
      if (!Phone.isEmailValid(_emailController.text)) {
        _emailError = '无效的电子邮件地址';
      }

      // 如果所有验证都通过，显示成功消息
      if (_nationalIdError == null &&
          _cardNumberError == null &&
          _mobileNumberError == null &&
          _emailError == null) {
        ScaffoldMessenger.of(context).showSnackBar(
          const SnackBar(content: Text('表单验证通过！')),
        );
      }
    });
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        backgroundColor: Theme.of(context).colorScheme.inversePrimary,
        title: Text(widget.title),
      ),
      body: Padding(
        padding: const EdgeInsets.all(16.0),
        child: Column(
          children: [
            // 国家身份证输入框
            TextField(
              controller: _nationalIdController,
              decoration: InputDecoration(
                labelText: '国家身份证号',
                errorText: _nationalIdError,
              ),
            ),
            const SizedBox(height: 16),

            // 信用卡号输入框
            TextField(
              controller: _cardNumberController,
              decoration: InputDecoration(
                labelText: '信用卡号',
                errorText: _cardNumberError,
              ),
            ),
            const SizedBox(height: 16),

            // 手机号输入框
            TextField(
              controller: _mobileNumberController,
              decoration: InputDecoration(
                labelText: '手机号',
                errorText: _mobileNumberError,
              ),
            ),
            const SizedBox(height: 16),

            // 电子邮件输入框
            TextField(
              controller: _emailController,
              decoration: InputDecoration(
                labelText: '电子邮件',
                errorText: _emailError,
              ),
            ),
            const SizedBox(height: 16),

            // 提交按钮
            ElevatedButton(
              onPressed: _validateForm,
              child: const Text('提交'),
            ),
          ],
        ),
      ),
    );
  }
}