Syncfusion .NET MAUI TimePicker(SfTimePicker)是一个用于 .NET MAUI 应用的时间选择控件,用户可通过可滚动的界面选择时间值。该技能适用于在 .NET MAUI 中实现时间选择、时间输入 UI,以及添加和配置 SfTimePicker 控件。
主要能力
- 时间格式:提供 14 种预定义时间格式,支持 12/24 小时制,可包含小时、分钟、秒和毫秒。
- 选择器模式:包括 Default(内联)、Dialog(弹窗)和 RelativeDialog(定位弹窗)三种模式。
- 时间间隔:可设置小时、分钟、秒和毫秒的选择间隔。
- 时间限制:支持最小/最大时间以及黑名单时间(BlackoutTimes)。
- 循环:支持首尾项之间的无缝循环导航。
- 事件系统:涵盖选择变更、对话框生命周期以及底部按钮事件。
- MVVM 支持:通过 SelectionChangedCommand、AcceptCommand、DeclineCommand 等命令实现。
- 自定义:可定制头部、底部、列标题、选择视图和文本显示模式。
- 无障碍与本地化:支持面向全球应用的无障碍与本地化需求。
使用方式
该技能文档按主题组织,包含入门、格式化、选择器模式与显示、时间间隔与循环、时间限制、事件与命令、自定义与样式、无障碍与本地化等参考页面。入门部分涵盖 NuGet 包安装(Syncfusion.Maui.Toolkit)、处理程序注册(在 MauiProgram.cs 中配置 ConfigureSyncfusionToolkit)、基础 SfTimePicker 初始化(XAML 和 C#)、设置头部与底部视图、配置高度与宽度、使用 SelectedTime 属性以及清除选择。
格式化部分覆盖 Format 属性及 14 种预定义格式,例如 H_mm、H_mm_ss、HH_mm、HH_mm_ss、HH_mm_ss_fff、h_mm_tt、h_mm_ss_tt、hh_mm_tt、hh_mm_ss_tt、hh_mm_ss_fff_tt、hh_tt、mm_ss、mm_ss_fff、ss_fff,以及基于区域性的默认格式。
选择器模式部分覆盖 Mode 属性、Dialog 模式配置、IsOpen 属性、RelativeDialog 模式及其 RelativePosition 的 8 种对齐位置(AlignTop、AlignBottom、AlignToLeftOf、AlignToRightOf、AlignTopLeft、AlignTopRight、AlignBottomLeft、AlignBottomRight)、RelativeView 属性以及自定义弹窗尺寸(PopupWidth、PopupHeight)。
时间间隔与循环部分覆盖 HourInterval、MinuteInterval、SecondInterval、MilliSecondInterval 属性以及 EnableLooping 属性。时间限制部分覆盖 MinimumTime、MaximumTime 和 BlackoutTimes 集合。
事件与命令部分覆盖 SelectionChanged 事件及 TimePickerSelectionChangedEventArgs(包含 NewValue 和 OldValue)、IsSelectionImmediate 行为、Dialog 模式的 Opened/Closing/Closed 事件、底部视图的 OkButtonClicked 和 CancelButtonClicked 事件,以及 SelectionChangedCommand、AcceptCommand、DeclineCommand 等 MVVM 命令。
自定义与样式部分覆盖头部视图(Text、Height、Background、TextStyle)、底部视图(OkButtonText、CancelButtonText、ShowOkButton、Height、Background、TextStyle)、列标题视图、选择视图(Background、Stroke、StrokeThickness、CornerRadius、TextStyle)以及 TextDisplayMode 选项(Default、Fade、Shrink、FadeAndShrink)。
无障碍与本地化部分覆盖 WCAG 合规特性、屏幕阅读器支持、键盘导航、语义属性、本地化配置、区域特定的时间格式以及 RTL(从右到左)语言支持。
适用场景
适用于需要在 .NET MAUI 应用中实现时间选择、添加 SfTimePicker 控件、配置时间格式、设置对话框或定位选择器模式、定义时间间隔、限制可选时间(如营业时间、预约时段、屏蔽时间)、处理选择事件或使用 MVVM 命令、自定义外观,以及实现无障碍或本地化时间选择器的场景。
限制
该技能资料未提供关于收费、价格、具体平台支持矩阵或效果保证的信息。部分属性与行为的细节需参考对应的参考页面,资料中未展开的内容暂未提供。