Flutter功能扩展插件coo_extensions的使用

coo_extensions

coo(l) extensions! 这是一组常用Dart/Flutter扩展，用于简化开发。

安装 Installation

要使用此软件包，请在pubspec.yaml文件中添加coo_extensions作为依赖项。

dependencies:
  coo_extensions: ^0.1.1

然后运行flutter pub get以安装该软件包。

使用 Usage

String Extensions 字符串扩展

• isNullOrEmpty: 检查字符串是否为null、空或仅包含空白字符。
• obscureText: 将字符串中的所有字符（除空格外）替换为星号（默认替换字符是’*’）。
• obscureTextSegment: 将字符串中的文本段落替换为星号（默认替换字符是’*’），使其无法识别。

示例：

import 'package:coo_extensions/string.extension.dart';

void main() {
  String? str = 'Hello World';

  // 检查字符串是否为null或空
  print(str.isNullOrEmpty); // 输出: false

  // 隐藏字符串内容
  print(str.obscureText()); // 输出: ***** *****
}

DateTime Extensions 日期时间扩展

• isToday: 检查DateTime对象是否表示今天的日期。
• isYesterday: 检查DateTime对象是否表示昨天的日期。
• isSameYear: 检查DateTime对象是否属于当前年份。
• isAfterOrEqual: 检查当前DateTime是否晚于或等于给定的DateTime。
• isBeforeOrEqual: 检查当前DateTime是否早于或等于给定的DateTime。
• isBetween: 检查当前DateTime是否在给定的两个日期之间。

示例：

import 'package:coo_extensions/date_time.extension.dart';

void main() {
  DateTime now = DateTime.now();

  // 检查DateTime对象是否为今天
  print(now.isToday); // 输出: true
}

BuildContext Extensions 构建上下文扩展

• isLightMode: 检查应用程序当前是否处于浅色模式。
• isDarkMode: 检查应用程序当前是否处于深色模式。
• deviceWidth: 获取设备屏幕宽度。
• deviceHeight: 获取设备屏幕高度。

示例：

import 'package:coo_extensions/build_context.extension.dart';
import 'package:flutter/material.dart';

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

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    // 检查应用是否处于浅色模式
    print(context.isLightMode); // 输出: true 或 false

    // 获取设备屏幕宽度和高度
    print('Device Width: ${context.deviceWidth}');
    print('Device Height: ${context.deviceHeight}');

    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(title: Text('BuildContext Extensions Demo')),
        body: Center(child: Text('Check console for output.')),
      ),
    );
  }
}

Number Extensions 数字扩展

• isBetween: 检查数字是否在指定范围内。

示例：

import 'package:coo_extensions/number.extension.dart';

void main() {
  num? number = 5;

  // 检查数字是否在0到10之间
  print(number.isBetween(0, 10)); // 输出: true
}

Form Extensions 表单扩展

• isValid: 检查与GlobalKey关联的表单是否有效。

示例：

import 'package:flutter/material.dart';
import 'package:coo_extensions/form.extension.dart';

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

class MyApp extends StatelessWidget {
  final GlobalKey<FormState> formKey = GlobalKey<FormState>();

  @override
  Widget build(BuildContext context) {
    // 检查表单是否有效
    print(formKey.isValid); // 输出: true 或 false

    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(title: Text('Form Extensions Demo')),
        body: Form(
          key: formKey,
          child: Column(
            children: <Widget>[
              TextFormField(
                validator: (value) {
                  if (value == null || value.isEmpty) {
                    return 'Please enter some text';
                  }
                  return null;
                },
              ),
              ElevatedButton(
                onPressed: () {
                  if (formKey.currentState!.validate()) {
                    // 如果表单有效，则执行某些操作
                    print('Form is valid');
                  }
                },
                child: Text('Submit'),
              ),
            ],
          ),
        ),
      ),
    );
  }
}

贡献 Contribution

欢迎贡献！如果您有任何问题或建议，可以随时提交issue或pull request。

许可 License

本软件包采用MIT许可证。详情请参阅LICENSE文件。