syncfusion-maui-toolkit-cards

实现 .NET MAUI Cards（SfCards）

Syncfusion .NET MAUI Cards 控件提供可关闭的单卡视图（SfCardView）和可滑动的卡片堆栈（SfCardLayout）。本技能涵盖安装、创建卡片、滑动手势、自定义、数据绑定、事件和现代视觉效果。

何时使用此技能

当用户需要以下功能时，请使用此技能：

• 创建可关闭的卡片视图 - 可通过向左或向右滑动来关闭的单张卡片
• 构建卡片堆栈 - 多张堆叠卡片，并支持滑动导航
• 实现滑动手势 - 可响应四个方向（左、右、上、下）滑动的卡片
• 显示卡片式 UI - 用于组织内容的可视化卡片容器
• 添加交互式卡片 - 支持点击事件、关闭事件和状态管理的卡片
• 将数据绑定到卡片 - 使用 BindableLayout 从数据集合动态生成卡片
• 自定义卡片外观 - 边框、圆角、指示器、颜色。
• 处理卡片事件 - 点击、关闭中、已关闭、索引更改事件

此技能专用于 Syncfusion 的 .NET MAUI Cards 控件（SfCardView 和 SfCardLayout），不适用于通用卡片布局或其他卡片库。

组件概述

Syncfusion .NET MAUI Cards 控件提供两个主要组件：

1. SfCardView - 可选择通过滑动来关闭的单张卡片
2. SfCardLayout - 用于堆叠多个 SfCardView 项并支持滑动导航的容器

主要功能：

• 滑动关闭功能
• 支持多方向滑动（左、右、上、下）
• 视觉自定义（边框、圆角、指示器）
• 以编程方式关闭卡片
• 使用 BindableLayout 进行数据绑定
• 全面的事件处理

文档和导航指南

开始使用

📄 阅读： references/getting-started.md

当用户需要以下内容时，请阅读此参考资料：

• 安装 Syncfusion.Maui.Toolkit NuGet 包
• 在 MauiProgram.cs 中注册 Syncfusion 处理程序（ConfigureSyncfusionToolkit）
• 创建第一个 SfCardView
• 了解基本的 XAML 和 C# 实现模式

卡片视图功能

📄 阅读： references/card-views.md

当用户使用单张卡片并需要以下内容时，请阅读此参考资料：

• SfCardView 组件概述和用法
• 用于滑动关闭功能的 SwipeToDismiss 属性
• 用于以编程方式关闭卡片的 IsDismissed 属性
• FadeOutOnSwiping 视觉效果
• 单卡片实现模式
• 独立卡片场景

卡片布局功能

📄 阅读： references/card-layouts.md

当用户需要以下卡片堆栈功能时，请阅读此参考资料：

• SfCardLayout 组件（多张堆叠卡片）
• 用于显示边缘卡片的 ShowSwipedCard 属性
• 用于卡片导航的 VisibleIndex 属性
• SwipeDirection 配置（Left、Right、Top、Bottom）
• 多张卡片管理
• 卡片之间的滑动手势导航

自定义和样式设置

📄 阅读： references/customization.md

当用户希望自定义以下内容时，请阅读此参考资料：

• BorderColor、BorderWidth、CornerRadius 属性
• 背景颜色和渐变
• 指示器自定义（颜色、粗细、位置）
• FadeOutOnSwiping 效果
• 高级视觉样式设置
• 自定义卡片设计和主题

使用 BindableLayout 进行数据绑定

📄 阅读： references/data-binding.md

当用户需要以下内容时，请阅读此参考资料：

• 从数据集合动态生成卡片
• 在 SfCardLayout 中使用 BindableLayout
• 设置 ViewModel 和数据源
• 配置 ItemsSource 和 ItemTemplate
• 创建数据驱动的卡片界面
• 将卡片属性绑定到数据模型

事件与交互

📄 阅读： references/events.md

当用户需要处理以下内容时，请阅读此参考文档：

• Tapped 事件（检测卡片点击）
• VisibleIndexChanging 事件（卡片切换前触发，支持 Cancel）
• VisibleIndexChanged 事件（卡片切换后触发）
• Dismissing 事件（关闭前触发，支持 Cancel）
• Dismissed 事件（关闭完成后触发）
• 事件处理程序的实现和使用场景