Flutter表单验证插件Validated的使用

validated 是一个强大的Dart和Flutter字符串验证库，包含45个验证器和清理器。本文将介绍如何在Flutter应用中使用该插件进行表单验证，并提供完整的示例代码。

安装

首先，在你的pubspec.yaml文件中添加validated依赖：

dependencies:
  flutter:
    sdk: flutter
  validated: ^latest_version

记得替换^latest_version为最新版本号，可以通过Pub.dev查看。

使用方法

导入库

在需要使用的文件顶部导入validated包：

import 'package:validated/validated.dart' as validate;

验证函数示例

下面是一些基本的验证函数示例：

void main() {
  print(validate.isBoolean('a')); // false
  print(validate.isEmail("adib@gmail.com")); // true
  print(validate.isAscii("ABCDEF")); // false
  print(validate.isSameType('String', false)); // false
  print(validate.isUpperCase("ADIB")); // true
  print(validate.isCapitalized("Adib")); // true
  print(validate.contains("Dart is nice", "nice")); // true
  print(validate.isCurrency("\$")); // false
  print(validate.isURL('https://www.google.com')); // true
  print(validate.isEmoji("😀")); // true
}

清理器（Sanitizers）

除了验证功能外，validated还提供了多种数据类型转换的清理器：

void sanitizeExample() {
  String booleanStr = 'true';
  bool booleanValue = validate.toBoolean(booleanStr);
  
  String dateStr = '2023-10-01';
  DateTime dateValue = validate.toDate(dateStr);
  
  String doubleStr = '123.45';
  double doubleValue = validate.toDouble(doubleStr);
  
  String floatStr = '123.45';
  float floatValue = validate.toFloat(floatStr);
  
  String intStr = '123';
  int intValue = validate.toInt(intStr);
  
  var obj = {'key': 'value'};
  String strFromObj = validate.toString(obj);
}

完整Demo

以下是一个完整的Flutter应用示例，演示了如何使用validated进行表单验证：

import 'package:flutter/material.dart';
import 'package:validated/validated.dart' as validate;

void main() => runApp(MyApp());

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Validated Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: MyHomePage(title: 'Validated Demo Home Page'),
    );
  }
}

class MyHomePage extends StatefulWidget {
  MyHomePage({Key key, this.title}) : super(key: key);

  final String title;

  @override
  _MyHomePageState createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  final TextEditingController _emailController = TextEditingController();
  final GlobalKey<FormState> _formKey = GlobalKey<FormState>();

  void _validateInputs() {
    if (_formKey.currentState.validate()) {
      ScaffoldMessenger.of(context).showSnackBar(SnackBar(content: Text('Processing Data')));
    } else {
      ScaffoldMessenger.of(context).showSnackBar(SnackBar(content: Text('Fix Errors')));
    }
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text(widget.title),
      ),
      body: Form(
        key: _formKey,
        child: Column(
          children: <Widget>[
            TextFormField(
              controller: _emailController,
              decoration: InputDecoration(labelText: 'Email'),
              validator: (value) {
                if (!validate.isEmail(value)) {
                  return 'Please enter a valid email address';
                }
                return null;
              },
            ),
            ElevatedButton(
              onPressed: _validateInputs,
              child: Text('Submit'),
            )
          ],
        ),
      ),
    );
  }
}

这个示例展示了如何创建一个简单的登录界面，并利用validated插件对用户输入的电子邮件地址进行格式验证。如果输入无效，则会显示错误消息；否则，应用程序将处理提交的数据。