Flutter命名日API插件flutter_nameday_api的使用

是否需要在您的应用程序中实现命名日功能？此插件可以通过加快从互联网获取命名日数据来帮助您实现这一目标。它是对Abalin.net命名日API的封装，因此您无需处理请求和解析JSON。

Abalin API 是国际化的，目前支持来自全球20个国家的命名日。

目录

• 特性
• 支持的国家
• 使用方法
• 示例
• 致谢
• 功能、错误报告与反馈

特性 #

1. 获取20个国家今天、明天或昨天庆祝的命名日。
2. 确定某一天庆祝的命名日。
3. 按日期搜索命名日。

支持的国家 #

使用方法 #

目前可用的方法如下表所示：

更多用法信息可以在示例或Dart文档中查看。

示例 #

所有上述方法都返回其各自的未来类（Future），只需将其插入到FutureBuilder中即可：

FutureBuilder(
  future: Nameday.today(), // 获取今天的命名日
  builder: (context, snapshot) {
    if (snapshot.hasData) {
      // 将快照数据分配给未来方法返回的类类型
      OneDayData nameDays = snapshot.data;

      return ExpansionTile(
        title: Text('今日命名日'),
        children: [
          SingleChildScrollView(
            child: Column(
              children: [
                Text('今天是 ${nameDays.month}/${nameDays.day}'),
                for (var element in nameDays.nameDays)
                  Text(
                    element,
                    style: _textStyle(),
                  ),
              ],
            ),
          ),
        ],
      );
    } else {
      return CircularProgressIndicator(); // 加载动画
    }
  },
),

您可以在示例页面中找到包含所有方法的完整示例。

示例代码 #

以下是完整的示例代码，展示了如何使用插件实现命名日功能：

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

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

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: Text('Flutter命名日API'),
        ),
        body: SingleChildScrollView(
          child: Column(
            children: _tiles,
          ),
        ),
      ),
    );
  }
}

// 插件的主要部分在这里
List<FutureBuilder> _tiles = [
  // 使用内置方法创建FutureBuilder
  FutureBuilder(
    future: Nameday.today(), // 获取今天的命名日
    builder: (context, snapshot) {
      if (snapshot.hasData) {
        OneDayData nameDays = snapshot.data;

        return ExpansionTile(
          title: Text('今日命名日'),
          children: [
            SingleChildScrollView(
              child: Column(
                children: [
                  Text('今天是 ${nameDays.month}/${nameDays.day}'),
                  for (var element in nameDays.nameDays)
                    Text(
                      element,
                      style: _textStyle(),
                    ),
                ],
              ),
            ),
          ],
        );
      } else {
        return CircularProgressIndicator(); // 加载动画
      }
    },
  ),
  FutureBuilder(
    future: Nameday.yesterday(), // 获取昨天的命名日
    builder: (context, snapshot) {
      if (snapshot.hasData) {
        OneDayData nameDays = snapshot.data;

        return ExpansionTile(
          title: Text('昨日命名日'),
          children: [
            SingleChildScrollView(
              child: Column(
                children: [
                  Text('昨天是 ${nameDays.month}/${nameDays.day}'),
                  for (var element in nameDays.nameDays)
                    Text(
                      element,
                      style: _textStyle(),
                    ),
                ],
              ),
            ),
          ],
        );
      } else {
        return CircularProgressIndicator(); // 加载动画
      }
    },
  ),
  FutureBuilder(
    future: Nameday.tomorrow(), // 获取明天的命名日
    builder: (context, snapshot) {
      if (snapshot.hasData) {
        OneDayData nameDays = snapshot.data;

        return ExpansionTile(
          title: Text('明日命名日'),
          children: [
            SingleChildScrollView(
              child: Column(
                children: [
                  Text('明天是 ${nameDays.month}/${nameDays.day}'),
                  for (var element in nameDays.nameDays)
                    Text(
                      element,
                      style: _textStyle(),
                    ),
                ],
              ),
            ),
          ],
        );
      } else {
        return CircularProgressIndicator(); // 加载动画
      }
    },
  ),
  FutureBuilder(
    future: Nameday.specificDay(day: 28, month: 3), // 按指定日期搜索命名日
    builder: (context, snapshot) {
      if (snapshot.hasData) {
        SpecificDayData nameDays = snapshot.data;

        return ExpansionTile(
          title: Text('按日期搜索命名日'),
          children: [
            SingleChildScrollView(
              child: Column(
                children: [
                  Text('${nameDays.month}/${nameDays.day} 的命名日'),
                  for (var element in nameDays.nameDays)
                    Text(
                      element,
                      style: _textStyle(),
                    ),
                ],
              ),
            ),
          ],
        );
      } else {
        return CircularProgressIndicator(); // 加载动画
      }
    },
  ),
  FutureBuilder(
    future: Nameday.searchByName(name: 'János', country: Countries.hu), // 按姓名搜索命名日
    builder: (context, snapshot) {
      if (snapshot.hasData) {
        SearchByNameData nameDays = snapshot.data;

        return ExpansionTile(
          title: Text('按姓名搜索日期'),
          children: [
            SingleChildScrollView(
              child: Column(
                children: [
                  Text('搜索结果数量: ${nameDays.resultCount}'),
                  for (var result in nameDays.results)
                    Text(
                      '${result.month}/${result.day}',
                      style: _textStyle(),
                    ),
                ],
              ),
            ),
          ],
        );
      } else {
        return CircularProgressIndicator(); // 加载动画
      }
    },
  ),
];

// 样式设置
TextStyle _textStyle() {
  return TextStyle(
    fontSize: 16.0,
    fontWeight: FontWeight.w300,
  );
}