SuperAPI AI 工具集

syncfusion-maui-toolkit-cards

前端与建站

查看项目

更新于 10-16 02:16

技能介绍

用途

本技能用于在 .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),不适用于通用卡片布局或其他卡片库。关于具体版本要求、平台支持范围、授权与收费信息,资料中暂未提供。