mcpField
S
syncfusion-maui-date-picker

syncfusion-maui-date-picker

github.com/syncfusion开发61214 次安装2 周前更新
代码仓库

关于 syncfusion-maui-date-picker

面向 .NET MAUI 开发者的 Syncfusion SfDatePicker 实现技能,涵盖日期选择、显示模式与界面定制。还介绍日期限制、事件处理及本地化和无障碍配置。

主要功能

  1. 01支持多种日期格式与选择模式
  2. 02设置日期范围和禁用日期
  3. 03自定义选择器外观与布局
  4. 04处理选择、弹窗和按钮事件
  5. 05配置键盘导航与本地化

适用场景

  1. 01在 .NET MAUI 应用中添加日期选择
  2. 02限制用户可选日期范围
  3. 03按应用界面定制日期弹窗
  4. 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.md
advanced-features.md
customizations.md
date-restrictions.md
events-and-commands.md
formatting.md
getting-started.md
intervals-and-looping.md
picker-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