Flutter Gravatar头像生成插件flutter_gravatar的使用

插件简介

flutter_gravatar 是一个易于使用的Flutter/Dart包，用于生成Gravatar图像和配置文件URL。有关Gravatar的更多信息，请访问 Gravatar官网。

使用示例

下面是一个简单的例子，展示了如何使用flutter_gravatar来获取Gravatar图像URL、配置文件URL以及用户的哈希值：

final gravatar = Gravatar("yg@beerstorm.net");  

// 获取Gravatar图像URL
print(gravatar.imageUrl());

// 获取Gravatar配置文件URL，默认为.json格式
print(gravatar.profileUrl());
// 支持的格式有：.json, .xml, .vcf, .qr
print(gravatar.profileUrl(".xml"));

// 获取此用户电子邮件的Gravatar HASH
print(gravatar.hash());

API介绍

imageUrl 方法

用于生成Gravatar图像URL，参数如下：

• size: 图像大小，默认80。
• defaultImage: 默认图像URL或类型，默认为identicon。
• forceDefault: 是否强制使用默认图像，默认为false。
• rating: 限制适当的图像，默认为g。

更多关于这些参数的信息，请参考 Gravatar官方文档。

安装方法

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

dependencies:  
    flutter_gravatar: any

然后执行flutter packages get以安装插件。

完整示例Demo

以下是一个完整的示例代码，演示了如何在一个Flutter应用中使用flutter_gravatar插件：

import 'package:flutter/material.dart';
import 'package:flutter_gravatar/flutter_gravatar.dart';
import 'package:flutter_gravatar/utils.dart';

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

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Gravatar Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: MyHomePage(title: 'Flutter Gravatar 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 GlobalKey<FormState> _formKey = GlobalKey<FormState>();
  String? _email;
  Gravatar? _gravatar;
  Map<String, String> _formInput = {};

  @override
  void initState() {
    // 设置默认值
    _email = "yg@beerstorm.net";
    _gravatar = Gravatar(_email!);
    super.initState();
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text(widget.title!),
      ),
      body: Center(
        child: Column(
          children: [
            if (_gravatar != null)
              Container(
                child: Column(
                  children: [
                    Text("Email: $_email"),
                    Image.network(_gravatar!.imageUrl()),
                    ListTile(
                      title: Text("profileUrl: ${_gravatar!.profileUrl()}"),
                      subtitle: Text("hash: ${_gravatar!.hash()}"),
                    )
                  ],
                ),
              ),
            Form(
              key: _formKey,
              child: Column(
                children: [
                  TextFormField(
                    onChanged: (value) {
                      setState(() => _formInput["email"] = value);
                    },
                    decoration: const InputDecoration(
                      labelText: 'Email',
                      hintText: 'Enter an email address',
                    ),
                    validator: (value) {
                      if (value!.isEmpty || !value.trim().isValidEmail()) {
                        return 'a valid Email is required';
                      }
                      return null;
                    },
                  ),
                  SizedBox(height: 4),
                  ElevatedButton(
                    child: const Text('Continue'),
                    onPressed: () {
                      if (_formKey.currentState!.validate()) {
                        setState(() {
                          _email = _formInput["email"];
                          _gravatar = Gravatar(_email!);
                        });
                      }
                    },
                  ),
                ],
              ),
            ),
          ],
        ),
      ),
    );
  }
}

通过上述代码，您可以创建一个简单的Flutter应用程序，允许用户输入电子邮件地址并显示对应的Gravatar头像及信息。如果您有任何问题或需要进一步的帮助，欢迎访问 GitHub Issues页面 提交问题或贡献代码。