w_tools library
W Tools Library
一个功能丰富的 Flutter 工具库，提供了多种实用工具和组件， 帮助开发者快速构建高质量的 Flutter 应用。
Classes
- ApiClientId
- API 客户端标识符，用于标识不同的 API 客户端
- BaseLocalDataSource
- 本地数据源基础类，所有本地数据源都应继承此类
- BaseRemoteDataSource
- 网络数据源基础类，所有网络数据源都应继承此类
-
BaseRepository<
LocalDataSourceType extends BaseLocalDataSource?, RemoteDataSourceType extends BaseRemoteDataSource?> - 数据仓库基础类，用于整合本地数据源和网络数据源
- CardNumberInputFormatter
- TextEditingValue 相关说明：
-
CustomPopupRoute<
T> - 自定义弹出层路由类
- DioUtil
- Dio 工具类，用于创建和管理 Dio 实例
- DividerInputFormatter
- 通用分隔符输入格式化器 用于在文本输入时按照指定规则添加分隔符
- FormBuilderDatePicker
- 表单日期选择器组件
- HttpConfig
- HTTP 配置类，用于存储 HTTP 请求的配置信息
- IApiPath
- API 路径接口，定义获取基础 URL 的方法
- PerformanceData
- 性能数据类
- ToastQueueManager
- 队列管理类
- ToastWidgetCache
- 缓存管理类
- WApp
- 应用初始化和运行工具类
- WAppBar
- 自定义导航栏组件
- WAppBarConfig
- 导航栏配置类
- WBadge
- 徽章组件，用于显示角标或标记
- WBadgeConfig
- 徽章配置类，用于配置徽章的位置和显示状态
- WButton
- 点击效果组件
- WButtonConfig
- 按钮配置类
- WCacheInterceptor
- 缓存拦截器，用于缓存 HTTP 请求响应
- WCancelToken
- 取消令牌类，用于取消异步操作
- WClipRRect
- 圆角裁剪组件，用于为子组件添加圆角
- WClipRRectConfig
- 圆角裁剪配置类，用于配置裁剪的圆角
- WColumn
- WConfig
- 应用配置类，提供应用初始化和运行的核心功能
- WConfigSetup
- WConfig 配置辅助类，用于支持链式配置
- WContainer
- 增强版容器组件
- WContainerConfig
- 容器配置类
- WCookieInterceptor
- Cookie 拦截器，用于管理 HTTP 请求和响应中的 Cookie
- WCountdown
- 倒计时工具类，用于管理倒计时功能
- WEnv
- 环境配置管理工具类
- WFormBorder
- WFormBorder 组件是一个表单边框容器，用于为表单输入添加统一的边框样式和错误提示
- WFormBorderConfig
- 表单边框配置类，定义边框的样式和构建器
- WFormBorderDecoration
- WFormBorderState
- WFormBorder 的状态类
- WFormBorderWithData
- 带 WFormData 自动获取的 WFormBorder
- WFormBuilder
- 表单构建器组件，用于创建和管理表单
- WFormButton
- 表单按钮组件，用于创建可点击的表单字段
- WFormButtonConfig
- 表单按钮配置类，定义按钮的样式和行为
- WFormCheckbox
- 单个复选框字段组件
- WFormCheckboxConfig
- 复选框配置类，定义复选框的样式和行为
- WFormData
- 表单数据管理类，用于管理表单状态、错误处理和数据操作
-
WFormDropdown<
T> - 表单下拉选择组件
- WFormDropdownConfig
- 下拉选择配置类，定义下拉选择的样式和行为
-
WFormMultiDropdown<
T> - 表单多选下拉框组件
- WFormMultiDropdownConfig
- 多选下拉框配置类，定义多选下拉框的样式和行为
-
WFormRadioGroup<
T> - 表单单选按钮组组件
- WFormRadioGroupConfig
- 单选按钮组配置类，定义单选按钮组的样式和行为
- WFormTextField
- 表单单行文本输入组件
- WFormTextFieldConfig
- 文本输入配置类，定义文本输入的样式和行为
- WFormValidators
- 表单验证器类，用于管理和执行表单验证
- WFormValidatorsConfig
- 表单验证器配置类，定义验证器的行为
- WFormValidatorsItem
- 表单验证项类，定义单个字段的验证规则
- WFuture
- 异步操作助手
- WFutureConfig
- 异步操作配置类
- WGet
- Get 扩展工具类，提供路由管理和弹窗显示功能
- WGetXRouterObserver
- GetX 路由观察者，用于监听路由变化并维护路由列表
- WGradientCircularProgressIndicator
- 带渐变效果的圆形进度指示器
- WImage
- 图片组件
- WImageConfig
- 图片配置类
- WImageGlobalConfig
- 图片全局配置类
- WKeepAliveWrapper
- 页面保持组件，用于保持子组件的状态
- WLanguage
- 语言管理类，用于管理应用语言设置并在语言变更时通知监听者
- WListView
- 增强版列表组件
- WListViewConfig
- 列表配置类
- WListViewState
- WLogger
- 日志工具类，提供静态方法访问日志功能
- WLogInterceptor
- 日志拦截器，用于记录 HTTP 请求和响应的详细信息
- WNetworkImageWithRetry
- 支持重试的网络图片组件
- WNetworkImageWithRetryState
- WnnTextInputFormatter
- 文本输入格式化器工具类
-
WNotificationListener<
T extends Notification> - 通知监听器构建器，用于创建和配置 NotificationListener 组件
- WPadding
- Padding 工具类，提供静态工厂方法
- WPerformance
- 性能监控工具类
- WPlatform
- 平台工具类
- WQrView
- 二维码扫描组件，用于扫描和识别二维码
- WQrViewOverlayShape
- 二维码扫描框样式配置类
- WRegExp
- WRegExpCategory
- WRegExpStr
- WRichText
- 富文本组件，用于显示包含多种样式的文本
- WRichTextConfig
- 富文本配置类，用于配置富文本的样式
- WRow
- WRowButtons
- 横向滚动按钮组件，用于创建可横向滚动的按钮列表
- WRowButtonsController
- 横向滚动按钮控制器，用于管理按钮的选中状态和滚动
- WScaffold
- 增强版脚手架组件，提供更多自定义选项
- WScaffoldConfig
- WScaffold 配置类，用于链式构建 WScaffold
- WSecret
- 加密工具类，提供各种加密和哈希功能（聚合类）
- WStep
- 步骤指示器组件
- WStepConfig
- 步骤指示器配置类
- WStorage
- 基于 SharedPreferences 的静态工具类，用于本地存储操作
- WTabBar
- 自定义标签栏组件
- WTabBarConfig
- 标签栏配置类
- WText
- 文本组件，用于显示和配置文本样式
- WTextConfig
- 文本配置类，用于配置文本的样式
- WToast
- WToast 工具类，用于显示自定义对话框
- WToastConfig
- WToast 配置类，用于管理 WToast 的配置
- WToastTheme
- WToast 主题类，用于统一管理提示样式
- WToken
- Token 管理类，用于管理 token 及过期时间
- WTokenInterceptor
- Token 拦截器，用于处理 token 的添加、更新和错误处理
- WUX
- 用户体验优化工具类
- WValidator
- 数据验证工具类，用于防止注入攻击和验证各种数据格式
Enums
- WButtonEffectType
- 按钮效果类型枚举
- WCountdownRemainingType
- 倒计时剩余时间格式化类型枚举
- WImageLoadStatus
- 图片加载状态枚举
- WImageType
- 图片类型枚举
- WPlatformType
- 平台类型
Extensions
- HexColor on Color
- 颜色扩展类，提供十六进制颜色转换功能
- RowBorderedExtension on Row
- Row 扩展，提供 buildBordered 方法
- WColumnExtension on Column
- Column 扩展，提供常用的布局辅助方法
- WCustomValidator on FormBuilderValidators
- FormBuilderValidators 的扩展，提供自定义验证器
- WFormBorderDecorationExtension on WFormBorderDecoration
- WFormBorderDecoration 扩展，提供链式调用方法
-
WGlobalKeyExtension
on GlobalKey<
State< StatefulWidget> > - GlobalKey 扩展类，提供获取组件位置和大小的方法
- WidgetExtension on Widget
- Widget 扩展，提供常用的布局辅助方法
- WImageExtension on Image
- 图片扩展类，提供图片预加载功能
-
WMapExtension
on Map<
K, V> - Map 扩展类，提供按键排序和合并的功能
- WNotificationListenerExtension on Widget
- WNotificationListener 的便捷构造函数扩展
- WNumExtension on num
- num 扩展类，提供便捷的 SizedBox 创建方法和其他实用方法
- WPicker on Picker
- Picker 扩展类，提供日期选择器相关功能
- WRegExpStringExtension on String
- String 扩展，提供正则表达式验证方法
- WRowExtension on Row
- Row 扩展，提供常用的布局辅助方法
- WSizeBox on SizedBox
- SizedBox 扩展类，提供便捷的高度和宽度创建方法
- WStringExtension on String
- String 扩展类，提供各种便捷方法
- WStrutStyle on StrutStyle
- StrutStyle 扩展类，提供从 WTextConfig 创建 StrutStyle 的方法
- WTextStyle on TextStyle
- TextStyle 扩展类，提供从 WTextConfig 创建 TextStyle 的方法
Constants
Functions
-
logD(
dynamic message, {DateTime? time, Object? error, StackTrace? stackTrace, String? tag}) → dynamic - 输出 Debug 级别的日志
-
logE(
dynamic message, {DateTime? time, Object? error, StackTrace? stackTrace, String? tag}) → dynamic - 输出 Error 级别的日志
-
logF(
dynamic message, {DateTime? time, Object? error, StackTrace? stackTrace, String? tag}) → dynamic - 输出 Fatal 级别的日志
-
logI(
dynamic message, {DateTime? time, Object? error, StackTrace? stackTrace, String? tag}) → dynamic - 输出 Info 级别的日志
-
logT(
dynamic message, {DateTime? time, Object? error, StackTrace? stackTrace, String? tag}) → dynamic - 输出 Trace 级别的日志
-
logW(
dynamic message, {DateTime? time, Object? error, StackTrace? stackTrace, String? tag}) → dynamic - 输出 Warning 级别的日志
-
showPopup(
{required BuildContext context, required WidgetBuilder builder, double? elevation, Color? shadowColor, Duration animationDuration = const Duration(milliseconds: 200)}) → void - 显示弹出层
Typedefs
- LibLogPrint = void Function(String message)
- 日志打印函数类型
- WCountdownCallback = void Function(int value)
- 倒计时回调函数类型
Exceptions / Errors
- WCancellationException
- 取消异常类