关于 syncfusion-maui-toolkit-date-picker
此技能指导开发者在 .NET MAUI 应用中实现和定制 Syncfusion SfDatePicker。内容涵盖日期格式、显示模式、日期限制、事件、无障碍功能与本地化。
主要功能
- 01日、月、年日期选择
- 02预设及自定义日期格式
- 03对话框与相对对话框模式
- 04最小值、最大值及禁用日期
- 05样式、事件与命令配置
- 06键盘导航与本地化
适用场景
- 01为 .NET MAUI 表单添加日期输入
- 02限制预约日期范围或禁用特定日期
- 03定制日期选择器外观与弹窗位置
- 04实现多语言且支持键盘操作的日期选择
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ syncfusion/ maui-toolkit-ui-components-skills --skill syncfusion-maui-toolkit-date-picker安装后在 Claude Code 中输入/syncfusion-maui-toolkit-date-picker确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
references/accessibility-localization.mdadvanced-features.mdcustomizations.mddate-restrictions.mdevents-and-commands.mdformatting.mdgetting-started.mdintervals-and-looping.mdpicker-modes.md详细介绍
实现 Syncfusion .NET MAUI DatePicker(SfDatePicker)
Syncfusion .NET MAUI DatePicker(SfDatePicker)控件提供外观丰富且可自定义的选择器界面,供你选择日期。该控件支持对话框和下拉模式,并提供丰富的自定义选项、日期限制、格式设置、本地化和无障碍功能。
何时使用此技能
在以下情况下使用此技能:
- 实现日期选择 - 在 .NET MAUI 应用程序中添加日期选择器控件
- 设置日期格式 - 以各种格式显示日期(20 多种预定义选项)
- 限制日期选择 - 设置最小/最大日期,或将特定日期设为不可选
- 自定义外观 - 设置标题、页脚、列标题和选中视图的样式
- 处理日期事件 - 响应日期选择、对话框打开/关闭以及“确定”/“取消”操作
- 配置选择器模式 - 使用 Dialog、RelativeDialog 或 Default 显示模式
- 添加间隔 - 设置选择日期的日/月/年间隔
- 启用无障碍功能 - 支持键盘导航和本地化
组件概述
主要功能:
- 日期选择 - 提供交互式日期选择器,包含日、月、年列
- 多种格式 - 提供 20 多种预定义日期格式(dd/MM/yyyy、MM/dd/yyyy 等)
- 选择器模式 - 支持 Dialog、RelativeDialog,并可自定义位置
- 自定义 - 可设置标题、页脚、列标题、选中视图、颜色和字体
- 日期限制 - 支持最小/最大日期和不可选日期集合
- 间隔 - 设置日、月、年间隔以自定义日期范围
- 事件和命令 - 支持 SelectionChanged、对话框事件和页脚按钮事件
- 无障碍功能 - 支持键盘导航、屏幕阅读器和本地化
- 高级功能 - 支持文本显示模式(Fade、Shrink)
文档和导航指南
入门
📄 阅读: references/getting-started.md
- 安装和 NuGet 包设置
- 在 MauiProgram.cs 中注册处理程序
- 基本 DatePicker 实现(XAML 和 C#)
- 设置标题、页脚、高度和宽度
- SelectedDate 属性和清除选择
日期格式
📄 阅读: references/formatting.md
- 20 多种预定义日期格式
- Format 属性用法
- 常见格式模式(dd_MM_yyyy、MM_dd_yyyy 等)
- 自定义格式示例
选择器模式和显示
📄 阅读: references/picker-modes.md
- Dialog 模式(弹出显示)
- RelativeDialog 模式(相对于视图定位)
- 8 种相对位置(AlignTop、AlignBottom 等)
- 使用 IsOpen 属性进行编程控制
- 自定义弹出窗口大小(PopupWidth、PopupHeight)
自定义和样式设置
📄 阅读: references/customizations.md
- 自定义标题(文本、分隔线、背景、模板)
- 自定义列标题(日/月/年标题)
- 自定义页脚(“确定”/“取消”按钮)
- 自定义选中视图(圆角半径、描边、内边距)
- 列分隔线颜色
- 关闭按钮和图标
- 针对各列设置文本样式和宽度
- 支持 DataTemplateSelector
日期限制
📄 阅读: references/date-restrictions.md
- MinimumDate 属性
- MaximumDate 属性
- BlackoutDates 集合
- 日期范围验证
- 防止选择范围之外的日期
间隔和循环
📄 阅读: references/intervals-and-looping.md
- DayInterval 属性
- MonthInterval 属性
- YearInterval 属性
- 使用 EnableLooping 实现无缝导航
事件和命令
📄 阅读: references/events-and-commands.md
- SelectionChanged 事件(NewValue、OldValue)
- Dialog 模式事件(Opened、Closing、Closed)
- 页脚事件(OkButtonClicked、CancelButtonClicked)
- SelectionChangedCommand、AcceptCommand、DeclineCommand
- 事件处理模式
无障碍功能与本地化
📄 阅读: references/accessibility-localization.md
- 标题、页脚和选择器项的无障碍功能
- 键盘导航(Tab、Enter、方向键)
- 本地化设置和资源文件
- CurrentUICulture 配置
- 多语言支持
高级功能
📄 阅读: references/advanced-features.md
- 文本显示模式(Default、Fade、Shrink、FadeAndShrink)
- 平台要求(.NET 10、macOS 26+、iOS 26+)
评论
支持 Markdown