关于 syncfusion-maui-date-picker
面向 .NET MAUI 开发者的 Syncfusion SfDatePicker 实现技能,涵盖日期选择、显示模式与界面定制。还介绍日期限制、事件处理及本地化和无障碍配置。
主要功能
- 01支持多种日期格式与选择模式
- 02设置日期范围和禁用日期
- 03自定义选择器外观与布局
- 04处理选择、弹窗和按钮事件
- 05配置键盘导航与本地化
适用场景
- 01在 .NET MAUI 应用中添加日期选择
- 02限制用户可选日期范围
- 03按应用界面定制日期弹窗
- 04为多语言应用配置日期选择器
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ syncfusion/ maui-ui-components-skills --skill syncfusion-maui-date-picker安装后在 Claude Code 中输入/syncfusion-maui-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 显示模式
- 添加间隔 - 设置日期/月/年的选择间隔
- 启用无障碍功能 - 支持键盘导航和本地化
- 应用现代效果 - 实现液态玻璃效果(.NET 10+)
组件概览
主要功能:
- 日期选择 - 交互式日期选择器,包含日、月、年列
- 多种格式 - 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)
- 对话框模式事件(Opened、Closing、Closed)
- 页脚事件(OkButtonClicked、CancelButtonClicked)
- SelectionChangedCommand、AcceptCommand、DeclineCommand
- 事件处理模式
无障碍功能和本地化
📄 阅读: references/accessibility-localization.md
- 标题、页脚和选择器项的无障碍功能
- 键盘导航(Tab、Enter、箭头键)
- 本地化设置和资源文件
- CurrentUICulture 配置
- 多语言支持
高级功能
📄 阅读: references/advanced-features.md
- 文本显示模式(Default、Fade、Shrink、FadeAndShrink)
- Liquid glass 效果集成
- SfGlassEffectView 设置
- EnableLiquidGlassEffect 属性
- 平台要求(.NET 10、macOS 26+、iOS 26+)
评论
支持 Markdown