hzy_normal_tools/hzy_normal_tools library

Functions

buildDividerLine({double height = 0.5, Color color = HzyNormalColorS.cole3e3e3, EdgeInsetsGeometry? padding, EdgeInsetsGeometry? margin, Decoration? decoration}) Widget
创建通用分割线组件 用于在列表项之间或其他需要分割的地方添加视觉分隔
chinaPhoneNumber(String input) bool
兼容旧版本的手机号验证方法(已废弃)
commentcomFormat(int value, String format, String single, String full) String
兼容旧版本的时间组件格式化方法(已废弃)
commentformatDate({required DateTime dateTime, String? format}) String
兼容旧版本的日期格式化方法(已废弃)
configDartVersion() → dynamic
兼容旧版本的Dart版本获取函数(已废弃)
configLineSpace({double height = 0.5, Color color = HzyNormalColorS.cole3e3e3, EdgeInsetsGeometry? padding, EdgeInsetsGeometry? margin, Decoration? decoration}) Widget
兼容旧版本的分割线方法(已废弃)
configPageState({required int allNum, required int networkNum, int? pageSize}) → dynamic
兼容旧版本的页面状态配置方法(已废弃)
configShowBottomSheet({required BuildContext context, required Widget child, BoxConstraints? constraints, Color? backgroundColor = Colors.transparent, ShapeBorder? shape = const ContinuousRectangleBorder(), bool isScrollControlled = false}) → dynamic
兼容旧版本的底部弹窗显示函数(已废弃)
configShowDialog({required BuildContext context, required Widget widget, bool barrierDismissible = true, Color? barrierColor = Colors.black54}) → dynamic
兼容旧版本的对话框显示函数(已废弃)
configYMD({required int year, required int m, required int d}) String
兼容旧版本的日期格式化方法(已废弃)
copyToClipboard(String text) Future<void>
将文本复制到系统剪贴板 用于实现复制功能,如复制链接、文本等
debugLog(Object? object) → void
调试模式下的日志输出 根据平台自动选择合适的日志输出方式
determinePageState({required int totalCount, required int currentPageCount, int? pageSize}) PageState
通用工具类 提供常用的工具方法,包括页面状态管理、时间格式化、数据验证等 根据列表数据配置页面状态 用于分页加载场景,自动判断当前页面应该显示的状态
dPrint(Object? object) → dynamic
兼容旧版本的调试打印函数(已废弃)
formartNum(num target, int postion, {bool isCrop = false}) String
兼容旧版本的数字格式化方法(已废弃)
formatDateTime({required DateTime dateTime, String? format}) String
格式化日期时间为指定格式 支持多种格式化模式,自动处理补零
formatDateYMD({required int year, required int month, required int day}) String
格式化日期为 yyyy-MM-dd 格式 自动补零确保月份和日期为两位数
formatMessageTime(int timestamp) String
格式化消息时间为相对时间或绝对时间 根据时间间隔自动选择合适的显示格式
formatNum(double num, {int postion = 2}) String
兼容旧版本的数字格式化方法(已废弃)
formatNumber(num number, {int decimalPlaces = 2, bool isTruncate = false}) String
格式化数字为指定小数位数的字符串 支持四舍五入和直接截断两种模式
getClipboardData() Future<ClipboardData?>
从系统剪贴板获取文本内容 用于实现粘贴功能
getClipboardText() Future<String?>
从系统剪贴板获取纯文本内容 便捷方法,直接返回文本字符串
getColorFromHex(String? hexColor) Color
兼容旧版本的颜色解析函数(已废弃)
getDartVersion() String
获取当前Dart运行时版本信息 返回包含Dart版本、平台信息等的完整字符串
getDataToClipboard() → dynamic
兼容旧版本的剪贴板获取方法(已废弃)
hideKeyboard(BuildContext context) → void
隐藏软键盘 用于在用户完成输入或需要隐藏键盘时调用
keydissMiss(BuildContext context) → dynamic
兼容旧版本的键盘隐藏方法(已废弃)
messageTime(int timeStamp) String
兼容旧版本的消息时间格式化方法(已废弃)
modalBottomSheet<T>({required BuildContext context, required Widget child, Color? backgroundColor, double? elevation, ShapeBorder? shape, Clip? clipBehavior, BoxConstraints? constraints, bool? enableDrag, bool isDismissible = true, bool isScrollControlled = false}) Future<T?>
显示模态底部弹窗 用于展示底部操作面板、选择器等内容
p(String msg) → dynamic
兼容旧版本的长文本打印函数(已废弃)
parseHexColor(String? hexColor) Color
将16进制颜色字符串转换为Color对象 支持多种格式的16进制颜色值
printLongText(String message, {int maxLength = 1000}) → void
长文本分段打印 用于打印超长日志信息,避免单次打印内容过多导致截断
requestFocus(BuildContext context) → dynamic
兼容旧版本的键盘显示方法(已废弃)
setDataToClipboard({required String text}) → dynamic
兼容旧版本的剪贴板设置方法(已废弃)
showCustomDialog<T>({required BuildContext context, required Widget child, bool barrierDismissible = true, Color? barrierColor = Colors.black54, String? barrierLabel, bool useSafeArea = true, bool useRootNavigator = true, RouteSettings? routeSettings, Offset? anchorPoint}) Future<T?>
显示通用对话框 用于展示各种类型的对话框内容
showKeyboard(BuildContext context) → void
请求显示软键盘 用于程序化地显示键盘,通常在自动聚焦输入框时使用
validateChinesePhoneNumber(String phoneNumber) bool
验证中国大陆手机号码格式 支持主流运营商号段,包括最新的号段

Typedefs

BooleanCallback = void Function(bool value)
布尔值回调
IndexTapCallback = void Function(int index)
通用回调函数类型定义 用于统一项目中的回调函数签名 带索引的点击回调
ItemTapCallback = void Function(HzyNormalItemModel itemModel, int? index)
列表项点击回调
OptionalIndexTapCallback = void Function(int? index)
可选索引的点击回调
SimpleTapCallback = void Function()
简单点击回调
TapBoolCallback = BooleanCallback
TapCallback = SimpleTapCallback
TapIndexCallback = IndexTapCallback
兼容旧版本的回调类型(已废弃)
TapIndexOptionCallback = OptionalIndexTapCallback
TapItemCallback = ItemTapCallback