SuperAPI AI 工具集

syncfusion-winui-circular-charts

前端与建站

查看项目

更新于 10-16 02:06

技能介绍

用途

本技能用于指导在 WinUI 应用中实现 Syncfusion WinUI 环形图(SfCircularChart),以饼图和圆环图形式展示比例或百分比数据。适用于市场份额、预算分配、调查结果等场景。

主要能力

  • 两种图表类型:PieSeries(饼图)与 DoughnutSeries(圆环图)。
  • 视觉元素:图例、数据标签、工具提示、标题/页眉。
  • 用户交互:扇区选中、扇区分离(explode)、切换可见性。
  • 多系列:可在同一图表中显示多个饼图或圆环图系列。
  • 动态更新:支持实时数据绑定与更新。
  • 外观定制:调色板、渐变、模板、样式。
  • 变体:半圆、四分之一圆,以及饼图与圆环图组合图表。

使用方式

  1. 安装 NuGet 包:Install-Package Syncfusion.Chart.WinUI。
  2. 创建数据模型与 ViewModel(如 Sales 类含 Product、SalesRate 属性)。
  3. 在 XAML 或 C# 中创建 SfCircularChart,设置 DataContext、Legend 与 Series。
  4. 通过 PieSeries/DoughnutSeries 的 ItemsSource、XBindingPath、YBindingPath 绑定数据。
  5. 按需启用 ShowDataLabels、EnableTooltip、SelectionBehavior、ExplodeOnTap 等。

技能提供以下参考文档:getting-started、pie-charts、doughnut-charts、legend、data-labels、tooltips、title-header、selection、explode-segments、appearance。

关键属性

SfCircularChart:Header、Legend、Series、TooltipBehavior。

PieSeries/DoughnutSeries:ItemsSource、XBindingPath、YBindingPath、ShowDataLabels、EnableTooltip、PaletteBrushes、Radius、InnerRadius、StartAngle、EndAngle、ExplodeIndex、ExplodeAll、ExplodeRadius、ExplodeOnTap、GroupTo、GroupMode、SelectionBehavior、DataLabelSettings、LegendIcon。

适用场景

  • 饼图:展示整体中的部分(市场份额、预算分配)、百分比分布(调查结果、人口统计)、5-7 个类别的简单比较、比例比精确值更重要时、单数据系列可视化。
  • 圆环图:需要更好标签放置(可利用中心)、多同心系列比较、需显示中心内容(总计、摘要)、偏好更现代外观、类别较多的密集数据。
  • 扇区分离:突出特定数据点、吸引注意、演示强调、交互探索(点击分离)。
  • 选中:筛选或下钻数据、交互式仪表板、多选比较、数据探索界面。

限制与最佳实践

  • 建议将扇区限制在 5-7 个以保证可读性,小值可用 GroupTo 分组。
  • 数据标签用于精确值,图例用于类别名称。
  • 启用工具提示以支持交互探索。
  • 多系列或需中心内容时考虑圆环图。
  • 谨慎使用选中,分离仅用于强调。
  • 选择对比色以区分扇区。
  • 测试响应性,环形图可适应不同尺寸。

相关组件

笛卡尔图表(时间序列、趋势、比较)、漏斗/金字塔图(层级或阶段数据)、仪表图(带范围的单值指标)。

暂未提供

关于收费、价格、平台支持范围、性能指标等具体信息,资料中暂未提供。