Flutter天气图标插件qweather_icons的使用

『 qweather_icons - QWeather Icons! 』

中文 Readme

最新更新: 2023-09-21 17:00:44

📚 简介

这是一个用于展示QWeather图标的插件。

📸 截图

或者尝试在线示例应用。

📦 如何使用

步骤一：添加最新版本到pubspec.yaml

在项目的pubspec.yaml文件中添加以下依赖：

dependencies:
  qweather_icons: ^1.6.0

步骤二：在任何地方使用它

在Dart代码中使用该图标：

Icon(QweatherIcons.tag_qweather),

步骤三：更多方法

以下是获取不同状态图标的几个方法：

/// 根据标签获取图标
///
/// 如果不存在，则返回默认值 `QWeatherIcons.tag_unknown`
factory QWeatherIcons.getIconWith(String? tag) {
  if (tag == null) return QWeatherIcons.tag_unknown;
  for (QWeatherIcons icons in QWeatherIcons.values) {
    if (icons.tag == tag) return icons;
  }
  return QWeatherIcons.tag_unknown;
}

/// 获取填充图标
///
/// 如果不存在，则返回默认值 `QWeatherIcons.tag_unknown`
factory QWeatherIcons.getFilledIconWith(QWeatherIcons qWeatherIcons) {
  if (qWeatherIcons.tag.endsWith('_fill')) return qWeatherIcons;
  for (QWeatherIcons icons in QWeatherIcons.values) {
    if ('${qWeatherIcons.tag}_fill' == icons.tag) return icons;
  }
  return QWeatherIcons.tag_unknown;
}

/// 获取未填充图标
///
/// 如果不存在，则返回默认值 `QWeatherIcons.tag_unknown`
factory QWeatherIcons.getUnfilledIconWith(QWeatherIcons qWeatherIcons) {
  if (!qWeatherIcons.tag.endsWith('_fill')) return qWeatherIcons;
  for (QWeatherIcons icons in QWeatherIcons.values) {
    if ('${icons.tag}_fill' == qWeatherIcons.tag) return icons;
  }
  return QWeatherIcons.tag_unknown;
}

⏳ 进度

已完成…

📌 注意事项

• 无

🧑‍💻 贡献者

🔦 声明

该项目采用BSD-3-Clause 许可证。详情请参阅LICENSE。

示例代码

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

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

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

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'QWeatherIcons Demo',
      theme: ThemeData.light(
        useMaterial3: true,
      ),
      darkTheme: ThemeData.dark(
        useMaterial3: true,
      ),
      themeMode: ThemeMode.system,
      home: const HomePage(),
    );
  }
}

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

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Row(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            Padding(
              padding: const EdgeInsets.all(8.0),
              child: Icon(QWeatherIcons.tag_qweather_fill.iconData),
            ),
            const Text('QWeatherIcons'),
          ],
        ),
      ),
      body: GridView.builder(
        gridDelegate: SliverGridDelegateWithFixedCrossAxisCount(
          crossAxisCount: MediaQuery.of(context).size.width > 1000 ? 12 : 6,
        ),
        itemCount: QWeatherIcons.values.length,
        itemBuilder: (context, index) => QWeatherCard(
          qWeatherIcons: QWeatherIcons.values[index],
        ),
      ),
    );
  }
}

class QWeatherCard extends StatelessWidget {
  const QWeatherCard({
    super.key,
    required this.qWeatherIcons,
  });

  final QWeatherIcons qWeatherIcons;

  [@override](/user/override)
  Widget build(BuildContext context) {
    return InkWell(
      onTap: () => showDialog(
        context: context,
        builder: (context) => AlertDialog(
          title: Center(
            child: Text(qWeatherIcons.tag),
          ),
          content: SizedBox(
            width: MediaQuery.of(context).size.width / 3,
            child: ListView(
              shrinkWrap: true,
              children: [
                ListTile(
                  leading: Icon(qWeatherIcons.iconData),
                  title: const Text('Usage: '),
                  subtitle: Text(
                    '${qWeatherIcons.runtimeType}.${qWeatherIcons.name}',
                  ),
                ),
                ListTile(
                  leading: Icon(
                    QWeatherIcons.getFilledIconWith(qWeatherIcons).iconData,
                  ),
                  title: const Text('Filled Icon: '),
                  subtitle: Text(
                    '${QWeatherIcons.getFilledIconWith(qWeatherIcons)}',
                  ),
                ),
                ListTile(
                  leading: Icon(
                    QWeatherIcons.getUnfilledIconWith(qWeatherIcons).iconData,
                  ),
                  title: const Text('Unfilled Icon: '),
                  subtitle: Text(
                    '${QWeatherIcons.getUnfilledIconWith(qWeatherIcons)}',
                  ),
                )
              ],
            ),
          ),
        ),
      ),
      child: Card(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.spaceEvenly,
          children: [
            Expanded(
              flex: 2,
              child: Icon(qWeatherIcons.iconData),
            ),
            Expanded(child: Text(qWeatherIcons.tag))
          ],
        ),
      ),
    );
  }
}