progressive_time_picker
一款可定制的 Flutter 渐进式时间选择器。此插件允许我们根据需求自定义时间选择器,用于从时间选择器中选择特定范围,并且支持多平台。
主要特点
- 支持选择两个选择器句柄。
- 易于定制时间选择器的装饰。
- 提供 12 或 24 小时制显示时钟数字的功能,也支持其自定义。
预览
基本用法
将其导入到您的项目文件
import 'package:progressive_time_picker/progressive_time_picker.dart';
并以最基本的形式添加它,例如
print(
‘onSelectionChange => init : ${a.h}:${a.m}, end : ${b.h}:${b.m}’),
onSelectionEnd: (a, b) =>
print(
‘onSelectionEnd => init : ${a.h}:${a.m}, end : ${b.h}:${b.m}’),
);
“>
‘onSelectionChange => init : ${a.h}:${a.m}, end : ${b.h}:${b.m}’),
onSelectionEnd: (a, b) =>
print(
‘onSelectionEnd => init : ${a.h}:${a.m}, end : ${b.h}:${b.m}’),
);
“>
TimePicker(
initTime: PickedTime(h: 0, m: 0),
endTime: PickedTime(h: 8, m: 0),
onSelectionChange: (a, b) =>
print(
'onSelectionChange => init : ${a.h}:${a.m}, end : ${b.h}:${b.m}'),
onSelectionEnd: (a, b) =>
print(
'onSelectionEnd => init : ${a.h}:${a.m}, end : ${b.h}:${b.m}'),
);
TimePicker 的必填参数
| 参数 | 描述 |
|---|---|
| PickedTime initTime | 选择的初始 PickedTime 值 |
| PickedTime endTime | 选择的结束 PickedTime 值 |
| onSelectionChange | 初始和结束 PickedTime 更改时的回调函数 |
| onSelectionEnd | 初始和结束 PickedTime 完成时的回调函数 |
TimePicker 的可选参数
| 参数 | 默认值 | 描述 |
|---|---|---|
| double height | 220 | 画布的高度 |
| double width | 220 | 画布的宽度 |
| int primarySectors | 0 | 要绘制的主扇形数量 |
| int secondarySectors | 0 | 要绘制的次扇形数量 |
| Widget 子项 | Container | 将装载在圆内的部件 |
| TimePickerDecoration decoration | – | 用于装饰我们的 TimePicker 部件 |
TimePickerDecoration 的必填参数
| 参数 | 描述 |
|---|---|
| TimePickerSweepDecoration sweepDecoration | 用于装饰我们的扫掠部分或初始点和结束点之间的部分,并提供各种选项 |
| TimePickerHandlerDecoration initHandlerDecoration | 用于装饰我们的时间选择器的初始句柄或结束句柄 |
| TimePickerHandlerDecoration endHandlerDecoration | 用于装饰我们的时间选择器的初始句柄或结束句柄 |
TimePickerDecoration 的可选参数
| 参数 | 默认值 | 描述 |
|---|---|---|
| Color baseColor | 青色点缀 | 定义选择器的背景颜色 |
| double pickerBaseCirclePadding | 0.0 | 为选择器的基础圆或外圆添加额外的内边距 |
| TimePickerSectorDecoration primarySectorsDecoration | – | 用于装饰我们时间选择器的主扇形 |
| TimePickerSectorDecoration secondarySectorsDecoration | – | 用于装饰我们时间选择器的次扇形 |
| TimePickerClockNumberDecoration clockNumberDecoration | – | 提供装饰选项,当启用时将应用于内部时钟的数字 |
贡献者指南
- 我们始终欢迎对我们的存储库做出贡献,我们请求贡献者为开发创建拉取请求。
报告问题/功能请求指南
如果报告者能分享以下内容来帮助我们了解问题的根本原因,那将对我们非常有帮助。
- 库版本
- 代码片段
- 日志(如适用)
- 设备规格(例如,制造商、操作系统版本等)
- 带重现步骤的屏幕截图/视频
- 使用的库
许可证!
progressive_time_picker 使用 MIT 许可证。
告诉我们!
如果您能向我们发送您使用我们组件的项目链接,我们将非常高兴。只需发送电子邮件至 [email protected]。如果您对我们的工作有任何疑问或建议,也请告知我们。
