Flutter插件djalmautil介绍与使用

Flutter插件djalmautil介绍与使用

djalma_util 是一个为 Flutter 项目中常用方法提供支持的插件。以下是该插件的一些主要功能及其用法。

ColorToMaterialColor(String colorHexSixCharacters)

将颜色转换为 MaterialColor 类型，传入的颜色值不包含 #（6个字符）。

// 示例
final MaterialColor materialColor = colorToMaterialColor("2196f3");

getFirebaseErrorMessage(String)

返回与 Firebase 错误相关的消息。

// 示例
try {
  // 这里是你的 Firebase 操作
} catch (e) {
  var errorMessage = getFirebaseErrorMessage(e.toString());
}

formatPrice(int price)

将从 Firestore 获取的价格格式化为整数形式，以便在 Text 小部件中显示。

// 示例
Text("价格格式化: ${formatPrice(1000)}");

formatPriceToFirestore(String price)

将价格格式化为适合保存到 Firestore 的字符串形式。

// 示例
Text("价格格式化为 Firestore 可用格式: ${formatPriceToFirestore("R\$ 10,00")}");

removeSpecialCharacters(String name)

移除字符串中的特殊字符并替换为空白。

// 示例
Text("移除特殊字符: ${"Preço".removeSpecialCharacters()}");

getMonthName(int mes)

返回给定月份编号对应的月份名称。

// 示例
Text("月份名称: ${getMonthName(12)}");

getMonthNumber(String month)

返回给定月份名称对应的月份编号。

// 示例
Text("月份编号: ${getMonthNumber("Janeiro")}");

getMonths() 和 getYears(int startFrom, int numberOfYearsToCount)

获取月份列表和年份列表。

// 示例
Text("所有月份: ${getMonths()}");

Text("所有年份: ${getYears(2020, 5).join(", ")}");

InternetConnection

检查 URL 是否可用及是否有互联网连接。

// 示例
Text("URL 可用性: ${isUrlAvailable("https://www.google.com")}");

Text("是否有互联网连接: ${isInternetAvailable()}");

完整示例代码

以下是一个完整的 Flutter 应用程序示例，展示了如何使用 djalma_util 插件中的各个功能。

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

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

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      debugShowCheckedModeBanner: false,
      title: 'Djalma Util',
      theme: ThemeData(
        primarySwatch: colorToMaterialColor("5e35b1"),
        visualDensity: VisualDensity.adaptivePlatformDensity,
      ),
      home: const MyHomePage(title: 'Djalma Util'),
    );
  }
}

class MyHomePage extends StatefulWidget {
  const MyHomePage({required this.title, super.key});

  final String title;

  [@override](/user/override)
  _MyHomePageState createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  Widget customVerticalSpacer() {
    return const SizedBox(height: 20);
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text(widget.title),
        centerTitle: true,
      ),
      body: Padding(
        padding: const EdgeInsets.all(16),
        child: SingleChildScrollView(
          child: Column(
            crossAxisAlignment: CrossAxisAlignment.stretch,
            mainAxisAlignment: MainAxisAlignment.start,
            children: [
              Text(
                "使用 colorToMaterialColor 将颜色转换为 MaterialColor，并应用于主主题",
              ),
              customVerticalSpacer(),
              Text("调用 getFirebaseErrorMessage(错误)，其中 '错误' 是 Firebase 操作中抛出的异常"),
              customVerticalSpacer(),
              Text("格式化价格: ${formatPrice(1000)}"),
              customVerticalSpacer(),
              Text("格式化价格以供 Firestore 使用: ${formatPriceToFirestore("R\$ 10,00")}"),
              customVerticalSpacer(),
              Text("移除特殊字符: ${"Preço".removeSpecialCharacters()}"),
              customVerticalSpacer(),
              Text("月份名称: ${getMonthName(12)}"),
              customVerticalSpacer(),
              Text("月份编号: ${getMonthNumber("Janeiro")}"),
              customVerticalSpacer(),
              Text("所有月份: ${getMonths().join(", ")}"),
              customVerticalSpacer(),
              Text("所有年份: ${getYears(2020, 5).join(", ")}"),
              customVerticalSpacer(),
              Text("URL 可用性: ${isUrlAvailable("https://www.google.com") ? "可用" : "不可用"}"),
              customVerticalSpacer(),
              Text("是否有互联网连接: ${isInternetAvailable() ? "有" : "无"}"),
            ],
          ),
        ),
      ),
    );
  }
}