mcpField
S
syncfusion-maui-toolkit-date-picker

syncfusion-maui-toolkit-date-picker

github.com/syncfusion设计与 UI3944 次安装7 周前更新
代码仓库

关于 syncfusion-maui-toolkit-date-picker

此技能指导开发者在 .NET MAUI 应用中实现和定制 Syncfusion SfDatePicker。内容涵盖日期格式、显示模式、日期限制、事件、无障碍功能与本地化。

主要功能

  1. 01日、月、年日期选择
  2. 02预设及自定义日期格式
  3. 03对话框与相对对话框模式
  4. 04最小值、最大值及禁用日期
  5. 05样式、事件与命令配置
  6. 06键盘导航与本地化

适用场景

  1. 01为 .NET MAUI 表单添加日期输入
  2. 02限制预约日期范围或禁用特定日期
  3. 03定制日期选择器外观与弹窗位置
  4. 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.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 显示模式
  • 添加间隔 - 设置选择日期的日/月/年间隔
  • 启用无障碍功能 - 支持键盘导航和本地化

组件概述

主要功能:

  • 日期选择 - 提供交互式日期选择器,包含日、月、年列
  • 多种格式 - 提供 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