Flutter数据验证插件meta_validator的使用

Flutter数据验证插件meta_validator的使用

介绍

meta_validator 是一个用于处理字符串验证的强大工具，支持iOS、Android、Web和Linux平台。它提供了多种内置的验证功能，如密码强度检查、电子邮件验证、邮政编码验证等。

安装

在 pubspec.yaml 文件中添加 meta_validator 依赖：

dependencies:
  meta_validator: ^<latest_version>

请确保将 <latest_version> 替换为最新的版本号。你可以通过访问 pub.dev 来获取最新版本。

主要功能

1. 密码强度检查

   • 使用 StrengthChecker.getPasswordStrength 方法可以检查密码的强度，返回值是一个介于0.0到1.0之间的浮点数。

   double strength = StrengthChecker.getPasswordStrength("some password");
   print("Password strength: $strength");
   

2. 自定义密码验证消息

   • 使用 StrengthChecker.getPasswordValidations 方法可以获取自定义的密码强度验证消息。

   String validationMessage = StrengthChecker.getPasswordValidations(
     password: "aaa",
     defaultTitle: "默认",
     mediumTitle: "中等",
     strongTitle: "强",
     weakTitle: "弱",
   );
   print("Password validation: $validationMessage");
   

3. 电子邮件验证

   • 使用 StringValidator.validateEmail 方法可以验证电子邮件地址是否有效。

   bool isValidEmail = StringValidator.validateEmail("fake email");
   print("Is valid email: $isValidEmail");
   

4. 邮政编码验证

   • 使用 StringValidator.validatePostalCode 方法可以验证邮政编码是否有效。

   bool isValidPostalCode = StringValidator.validatePostalCode("fake postal code");
   print("Is valid postal code: $isValidPostalCode");
   

5. 黑名单验证

   • 使用 StringValidator.validateBlacklisted 方法可以检查输入的单词是否在黑名单中。

   List<String> blacklistedWords = ["apple", "ball"];
   bool isBlacklisted = StringValidator.validateBlacklisted(blacklistedWords, "ball");
   print("Is blacklisted: $isBlacklisted");
   

6. 其他验证功能

   • 该库还提供了超过10种其他的字符串验证功能，具体可以参考官方文档。

完整示例Demo

以下是一个完整的Flutter应用程序示例，展示了如何使用 meta_validator 插件进行数据验证：

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

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

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Meta Validator Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: ValidationPage(),
    );
  }
}

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

class _ValidationPageState extends State<ValidationPage> {
  final TextEditingController _passwordController = TextEditingController();
  final TextEditingController _emailController = TextEditingController();
  final TextEditingController _postalCodeController = TextEditingController();
  final TextEditingController _wordController = TextEditingController();

  String _passwordValidationMessage = '';
  bool _isValidEmail = false;
  bool _isValidPostalCode = false;
  bool _isBlacklisted = false;

  void _validatePassword() {
    String password = _passwordController.text;
    if (password.isNotEmpty) {
      double strength = StrengthChecker.getPasswordStrength(password);
      String validationMessage = StrengthChecker.getPasswordValidations(
        password: password,
        defaultTitle: "默认",
        mediumTitle: "中等",
        strongTitle: "强",
        weakTitle: "弱",
      );
      setState(() {
        _passwordValidationMessage = validationMessage;
      });
    } else {
      setState(() {
        _passwordValidationMessage = '';
      });
    }
  }

  void _validateEmail() {
    String email = _emailController.text;
    bool isValid = StringValidator.validateEmail(email);
    setState(() {
      _isValidEmail = isValid;
    });
  }

  void _validatePostalCode() {
    String postalCode = _postalCodeController.text;
    bool isValid = StringValidator.validatePostalCode(postalCode);
    setState(() {
      _isValidPostalCode = isValid;
    });
  }

  void _validateWord() {
    String word = _wordController.text;
    List<String> blacklistedWords = ["apple", "ball"];
    bool isBlacklisted = StringValidator.validateBlacklisted(blacklistedWords, word);
    setState(() {
      _isBlacklisted = isBlacklisted;
    });
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Meta Validator Demo'),
      ),
      body: Padding(
        padding: const EdgeInsets.all(16.0),
        child: Column(
          children: [
            TextField(
              controller: _passwordController,
              decoration: InputDecoration(
                labelText: '输入密码',
                suffixIcon: IconButton(
                  icon: Icon(Icons.check),
                  onPressed: _validatePassword,
                ),
              ),
            ),
            SizedBox(height: 10),
            Text(_passwordValidationMessage, style: TextStyle(color: Colors.red)),
            SizedBox(height: 20),
            TextField(
              controller: _emailController,
              decoration: InputDecoration(
                labelText: '输入电子邮件',
                suffixIcon: IconButton(
                  icon: Icon(Icons.check),
                  onPressed: _validateEmail,
                ),
              ),
            ),
            SizedBox(height: 10),
            Text(_isValidEmail ? '有效的电子邮件' : '无效的电子邮件', style: TextStyle(color: _isValidEmail ? Colors.green : Colors.red)),
            SizedBox(height: 20),
            TextField(
              controller: _postalCodeController,
              decoration: InputDecoration(
                labelText: '输入邮政编码',
                suffixIcon: IconButton(
                  icon: Icon(Icons.check),
                  onPressed: _validatePostalCode,
                ),
              ),
            ),
            SizedBox(height: 10),
            Text(_isValidPostalCode ? '有效的邮政编码' : '无效的邮政编码', style: TextStyle(color: _isValidPostalCode ? Colors.green : Colors.red)),
            SizedBox(height: 20),
            TextField(
              controller: _wordController,
              decoration: InputDecoration(
                labelText: '输入单词',
                suffixIcon: IconButton(
                  icon: Icon(Icons.check),
                  onPressed: _validateWord,
                ),
              ),
            ),
            SizedBox(height: 10),
            Text(_isBlacklisted ? '黑名单中的单词' : '不在黑名单中', style: TextStyle(color: _isBlacklisted ? Colors.red : Colors.green)),
          ],
        ),
      ),
    );
  }
}