用途
本技能用于在 .NET MAUI 应用中实现 Syncfusion Cards 控件(SfCards),提供两类组件:可滑出关闭的单卡片视图(SfCardView)与可滑动切换的卡片堆叠容器(SfCardLayout)。当用户需要创建可滑动关闭的卡片、构建卡片堆叠、实现四方向滑动手势、展示卡片式 UI、添加可交互卡片、将数据集合绑定为卡片、定制卡片外观或处理卡片事件时,可使用本技能。
本技能专用于 Syncfusion 的 .NET MAUI Cards 控件(SfCardView 与 SfCardLayout),不适用于通用卡片布局或其他卡片库。
主要能力
- 滑动关闭(Swipe-to-dismiss)功能
- 多方向滑动支持(左、右、上、下)
- 视觉定制(边框、圆角、指示器)
- 以编程方式关闭卡片
- 通过 BindableLayout 进行数据绑定
- 完整的事件处理
组件构成:
- SfCardView:单张卡片,可选择通过滑动关闭
- SfCardLayout:用于堆叠多个 SfCardView 项并支持滑动导航的容器
使用方式
技能文档按主题分为多个参考文件,按需查阅:
- 入门(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 效果,高级视觉样式与自定义卡片设计。
- 数据绑定(references/data-binding.md):从数据集合动态生成卡片,将 BindableLayout 与 SfCardLayout 配合使用,设置 ViewModel 与数据源,配置 ItemsSource 与 ItemTemplate,创建数据驱动卡片界面,将卡片属性绑定到数据模型。
- 事件与交互(references/events.md):Tapped 事件(卡片点击检测)、VisibleIndexChanging 事件(卡片切换前,支持 Cancel)、VisibleIndexChanged 事件(卡片切换后)、Dismissing 事件(关闭前,支持 Cancel)、Dismissed 事件(关闭完成后),以及事件处理程序实现与场景。
适用场景
- 需要可滑动关闭的单卡片界面
- 需要多张卡片堆叠并支持滑动切换导航
- 需要卡片响应左、右、上、下四方向滑动
- 需要以卡片容器组织内容
- 需要带点击、关闭事件与状态管理的交互式卡片
- 需要根据数据集合动态生成卡片
- 需要定制卡片边框、圆角、指示器与颜色
限制
本技能仅针对 Syncfusion 的 .NET MAUI Cards 控件(SfCardView 与 SfCardLayout),不适用于通用卡片布局或其他卡片库。关于具体版本要求、平台支持范围、授权与收费信息,资料中暂未提供。