syncfusion-maui-circular-charts

实现 .NET MAUI 圆形图表

本技能将指导你实现 Syncfusion® .NET MAUI 圆形图表（SfCircularChart），该组件提供饼图、圆环图和径向条形图可视化，用于展示部分与整体的关系以及数据分布。

何时使用此技能

在以下场景中使用此技能：

• 展示比例数据 - 显示各部分对整体的贡献（市场份额、预算分配、调查结果）
• 创建饼图 - 将圆形图表划分为多个扇区
• 实现圆环图 - 创建带中心孔的圆形图表，可选择在中心显示其他信息
• 构建径向条形图 - 使用圆形进度指示器比较各类别的数值
• 展示数据分布 - 可视化百分比分布或类别比较
• 启用图表交互 - 添加工具提示、扇区分离效果、选择和图例
• 汇总较小数值 - 自动将较小的数据段合并到“其他”类别
• 导出可视化内容 - 将图表保存为图像或 PDF
• 自定义外观 - 设置颜色、描边、间距和视觉效果

组件概览

SfCircularChart 是用于圆形数据可视化的 .NET MAUI 控件，具备以下功能：

• 三种图表类型：PieSeries、DoughnutSeries、RadialBarSeries
• 数据绑定：使用 XBindingPath 和 YBindingPath 绑定集合
• 交互功能：工具提示、扇区分离、选择、图例
• 自定义设置：颜色、描边、间距、角度、半径控制
• 数据标签：在数据段上显示数值/百分比
• 汇总：将较小数值合并到“其他”类别
• 中心内容：在圆环图/径向条形图的中心显示自定义视图
• 导出：保存为 PNG、JPEG 或 PDF

文档与导航指南

入门

📄 阅读： references/getting-started.md

• 安装 NuGet 包（Syncfusion.Maui.Charts）
• SfCircularChart 的基本设置和初始化
• 创建数据模型和视图模型
• 将数据绑定到图表序列
• 添加标题、图例和数据标签
• 完整的最小可运行示例

图表类型

📄 阅读： references/chart-types.md

• PieSeries - 标准饼图实现
• DoughnutSeries - 带内半径和中心视图的圆环图
• RadialBarSeries - 圆形进度/比较条形图
• 用于调整图表大小的 Radius 属性
• 用于创建半圆图表的 StartAngle 和 EndAngle
• 圆环图和径向条形图的 InnerRadius 配置
• 用于显示中心内容的 CenterView 和 CenterHoleSize
• 所有图表类型的代码示例

数据标签

📄 阅读： references/data-labels.md

• 启用和配置数据标签
• 标签位置和对齐方式
• 自定义标签模板
• 防止标签重叠的智能定位
• 外部标签的连接线
• 标签格式（数值、百分比、自定义格式）
• 样式和外观自定义

图例

📄 阅读： references/legend.md

• 启用 ChartLegend
• 图例位置（顶部、底部、左侧、右侧）
• 图例图标类型和自定义设置
• 自定义图例模板
• 切换可见性功能
• 图例样式和外观

外观与样式

📄 阅读： references/appearance.md

• 使用 PaletteBrushes 设置数据段颜色
• 使用 Stroke 和 StrokeWidth 设置边框
• 使用 Opacity 设置透明度
• 使用 GapRatio 设置数据段间距（径向条形图）
• 使用 MaximumValue 设置径向条形图的范围
• 自定义 CapStyle（平直或弧形端点）
• 自定义径向条形图的轨道（TrackFill、TrackStroke）
• 自定义画笔和渐变填充

工具提示

📄 阅读： references/tooltip.md

• 使用 EnableTooltip 启用工具提示
• 默认工具提示行为
• 自定义工具提示模板
• 自定义工具提示内容
• 设置工具提示外观样式
• 交互式悬停行为

扇出功能

📄 阅读： references/explode.md

• 将图表扇区向外展开
• 使用 ExplodeIndex 指定要展开的扇区
• 使用 ExplodeRadius 设置展开距离
• 使用 ExplodeOnTouch 支持用户交互
• 展开多个扇区
• 突出显示并分隔扇区

选择

📄 阅读： references/selection.md

• 启用选择行为
• 配置 SelectionBehavior
• 选择模式（单选、多选）
• 处理选中索引
• 提供选择的视觉反馈
• 选择多个扇区

数据分组

📄 阅读： references/groupto.md

• 使用 GroupTo 属性自动分组
• 将较小的值合并到“其他”类别
• 设置分组阈值
• 自定义分组标签和外观
• 提高包含许多小扇区的图表的可读性

无障碍功能

📄 阅读： references/accessibility.md

• 屏幕阅读器播报标题、扇区和图例项
• 在各个平台启用无障碍功能（TalkBack、VoiceOver、Narrator）
• 键盘导航（Windows Narrator、macOS VoiceOver）
• 手势导航（Android TalkBack、iOS VoiceOver）
• 系列兼容性（不支持 RadialBarSeries）
• 提供有意义的标签，以便播报有效信息

导出图表

📄 阅读： references/exporting.md

• 导出为 PNG 或 JPEG 图片
• 导出为 PDF 文档
• 使用 SaveAsImage 和 GetStreamAsync 方法
• 基于流导出
• 导出质量和分辨率设置
• 各种导出格式的代码示例