syncfusion-maui-kanban-board

在 .NET MAUI 中实现看板

何时使用此技能

当用户需要：

• 在 .NET MAUI 应用中实现看板，用于任务管理
• 可视化工作流在不同完成阶段的状态（待办、进行中、已完成等）
• 创建敏捷看板，用于迭代规划和任务跟踪
• 构建基于卡片的界面，用于整理和管理分栏中的项目
• 添加拖放功能，在不同工作流阶段之间移动任务
• 实现 WIP 限制（进行中的工作），限制各列的任务数量
• 配置工作流转换，限制卡片移动
• 自定义卡片模板，使用自定义数据模型和视觉设计
• 添加任务分类和状态指示器
• 支持 RTL/LTR 布局，为国际用户提供本地化支持

此技能介绍 Syncfusion .NET MAUI Kanban Board (SfKanban) 控件，它提供了高效的方式来可视化和管理工作流，并支持丰富的自定义选项。

组件概述

SfKanban 控件是一个适用于 .NET MAUI 应用的高交互性、可自定义看板。它支持：

• 工作流可视化，跨越多个阶段（列）
• 拖放卡片，在列之间移动
• 进行中的工作（WIP）限制，控制任务流
• 灵活的数据绑定，支持默认或自定义模型
• 丰富的卡片自定义选项，包括模板、图像、标签和指示器
• 列管理，支持自动生成或手动配置
• 工作流规则，限制卡片转换
• 事件，用于响应卡片交互和状态变化
• 排序和筛选功能
• 本地化，支持多语言
• 视觉效果，包括液态玻璃样式

主要功能：

• 可视化任意流程的工作流
• 限制进行中的工作（WIP）
• 使用允许/禁止状态管理工作流转换
• 高度自定义（卡片、列、主题）
• 在流程中实现平滑转换
• 支持默认和自定义数据模型

文档与导航指南

入门

📄 阅读： references/getting-started.md

阅读时机： 用户需要首次设置 SfKanban、安装软件包或创建第一个看板时。

涵盖主题：

• 安装 Syncfusion.Maui.Kanban NuGet 包
• 使用 ConfigureSyncfusionCore 注册处理程序
• 在 XAML 和 C# 中初始化 SfKanban
• 创建第一个看板
• 运行并测试应用

数据绑定

📄 阅读： references/data-binding.md

阅读时机： 用户需要为看板填充数据、使用默认 KanbanModel、创建自定义数据模型或配置 ItemsSource 时。

涵盖主题：

• 使用具有内置属性的默认 KanbanModel
• 创建带数据映射的自定义数据模型
• 使用 ObservableCollection 设置 ItemsSource
• 了解用于列分类的 ColumnMappingPath
• AutoGenerateColumns 与手动定义列
• 用于 MVVM 架构的 ViewModel 模式
• 绑定上下文配置

卡片

📄 阅读： references/cards.md

阅读时机： 用户需要自定义卡片外观、添加图像、标签、指示器或创建自定义卡片模板时。

涵盖主题：

• 卡片属性（Title、ImageURL、Category、Description、ID）
• 用于状态颜色的 IndicatorFill
• 用于标签的 Tags 集合
• 用于全面自定义的 CardTemplate
• 图像处理（程序集引用与本地路径）
• 卡片布局和设计模式
• 默认与自定义卡片 UI
• 自定义模型的 BindingContext

列

📄 阅读： references/columns.md

阅读时机： 用户需要配置列、设置宽度限制、定义类别、启用 WIP 限制或自定义列外观时。

涵盖主题：

• 列尺寸（MinimumColumnWidth、MaximumColumnWidth、ColumnWidth）
• 使用 Categories 属性对列进行分类
• AutoGenerateColumns 配置
• 使用 KanbanColumn 手动定义列
• 每列多个类别
• 进行中（WIP）限制（MinimumLimit、MaximumLimit）
• 列模板和自定义
• 列标题

工作流

📄 阅读： references/workflows.md

阅读时机： 用户需要限制卡片移动、定义允许的状态转换或阻止特定列中的拖放操作时。

涵盖主题：

• KanbanWorkflow 类定义
• 用于源状态的 Category 属性
• 用于目标状态的 AllowedTransitions
• 限制卡片在列之间移动
• 阻止特定状态转换
• 工作流验证
• 状态管理示例

事件

📄 阅读： references/events.md

阅读时机： 用户需要处理拖放事件、卡片点击或响应卡片交互时。

涵盖主题：

• 拖放事件处理
• DragStart、DragOver、DragEnd 事件
• 卡片点击事件
• 事件参数和数据访问
• 自定义事件处理程序
• 阻止或允许拖动操作
• 基于事件的验证

排序

📄 阅读： references/sorting.md

阅读时机： 用户需要对列中的卡片排序或实现自定义排序逻辑时。

涵盖主题：

• 排序配置
• 自定义排序逻辑
• 排序顺序选项（升序、降序）
• 多个排序键
• IComparer 实现

高级功能

📄 阅读： references/advanced-features.md

阅读时机： 用户需要 RTL 支持、本地化或多语言配置时。

涵盖主题：

• 流向（LeftToRight、RightToLeft）
• 面向国际化应用的本地化支持
• 资源文件配置
• 多语言设置
• 区域性特定格式

自定义和样式

📄 阅读： references/customization.md

阅读时机： 用户需要自定义外观、液态玻璃效果、主题集成或迁移指南时。

涵盖主题：

• 用于现代 UI 样式的液态玻璃效果
• 外观自定义技术
• 与应用主题集成
• 卡片和列的自定义模板
• 样式最佳实践
• 从旧版本迁移的指南