Flutter自定义扩展功能插件coder_matthews_extensions的使用

Flutter自定义扩展功能插件coder_matthews_extensions的使用

特性

该包包含对列表、字符串、映射和异步函数的扩展。同时还包含一些有用的函数。

开始使用

无需任何设置，只需导入该包即可。

使用方法

列表扩展

final personList = [
  CoderPerson(name: "Jane", age: 16, gender: Gender.female),
  CoderPerson(name: 'Bob', age: 20, gender: Gender.male),
  CoderPerson(name: 'King', age: 56, gender: Gender.male),
];

final oldestPerson = personList.maxElement((element) => element.age); // 获取年龄最大的人
final youngestPerson = personList.minElement((element) => element.age); // 获取年龄最小的人
final totalAges = personList.sum((element) => element.age); // 计算总年龄
final isListNullOrEmpty = personList.isNullOrEmpty; // 检查列表是否为空或为null

字符串扩展

var control = '(342) 342-2314';
var result = control.toPhoneNumberString; // 转换为电话号码格式

String email = 'testemail@mail.com';
bool isValidEmail = email.isEmail; // 检查邮箱格式是否正确

映射扩展

var testMap = <String, dynamic>{
  'name': 'Tom',
  'age': null,
  'location': 'USA'
};
var newMap = testMap.removeNulls; // 移除所有值为null的键值对

检查设备是否为平板

var isTablet = await CoderMatthewsExtensions.isTablet(); // 检查当前设备是否为平板

示例代码

以下是一个完整的示例代码，展示了如何在应用中使用coder_matthews_extensions插件。

import 'package:coder_matthews_extensions/coder_matthews_extensions.dart';
import 'package:flutter/material.dart';
import 'dart:async';

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

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

  [@override](/user/override)
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  ThemeMode themeMode = ThemeMode.system;
  void setThemeMode(ThemeMode mode) {
    setState(() {
      themeMode = mode;
    });
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      themeMode: themeMode,
      theme: ThemeData(),
      darkTheme: ThemeData.dark(),
      navigatorKey: globalErrorHandler.navigationKey,
      initialRoute: "/",
      routes: {
        "/": (context) => Home(
              mode: themeMode,
              setThemeMode: setThemeMode,
            ),
        "/widget_position_example": (context) => const WidgetPositionExample(),
        "/shimmer_example": (context) => const ShimmerExample(),
      },
    );
  }
}

class Home extends StatefulWidget {
  final ThemeMode mode;
  final void Function(ThemeMode mode) setThemeMode;
  const Home({super.key, required this.mode, required this.setThemeMode});

  [@override](/user/override)
  State<Home> createState() => _HomeState();
}

class _HomeState extends State<Home> {
  String _platformVersion = 'Unknown';
  bool isTablet = false;
  final _coderMatthewsExtensionsPlugin = CoderMatthewsExtensions();

  [@override](/user/override)
  void initState() {
    super.initState();
    initPlatformState();
  }

  // 平台消息异步处理，初始化状态。
  Future<void> initPlatformState() async {
    String platformVersion;
    try {
      platformVersion = await _coderMatthewsExtensionsPlugin.getPlatformVersion() ?? 'Unknown platform version';
    } on PlatformException {
      platformVersion = 'Failed to get platform version.';
    }
    isTablet = await TabletExtensions.isTablet();

    if (!mounted) return;

    setState(() {
      _platformVersion = platformVersion;
    });
  }

  Map<String, String> get otherExamples => {
        '/widget_position_example': 'Widget Position Example',
        '/shimmer_example': 'Shimmer Loading Example',
      };

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: const Text('Plugin example app'),
      ),
      body: Center(
        child: Column(
          mainAxisSize: MainAxisSize.min,
          children: [
            Text('Running on: $_platformVersion\n'),
            Text(isTablet ? 'This device is a tablet' : 'This device is phone'),
            ElevatedButton(
                onPressed: () {
                  showBottomSheetThemeSwitcher(context, widget.mode, widget.setThemeMode);
                },
                child: const Text('Change Theme')),
            ElevatedButton(
                onPressed: () {
                  showDialog(
                      context: context,
                      builder: (context) {
                        return AlertDialog(
                          title: const Text('Other Examples'),
                          content: SingleChildScrollView(
                            child: Column(
                              mainAxisSize: MainAxisSize.min,
                              children: [
                                for (var item in otherExamples.entries)
                                  ElevatedButton(
                                      onPressed: () => Navigator.of(context).pushNamed(item.key),
                                      child: Text(item.value))
                              ],
                            ),
                          ),
                        );
                      });
                },
                child: const Text('Other Examples')),
            ElevatedButton(
                onPressed: () {
                  throw ApiServerErrorException(innerSource: String);
                },
                child: const Text('Test Global Exception Handler'))
          ],
        ),
      ),
    );
  }
}