syncfusion-maui-polar-charts

实现 .NET MAUI 极坐标图

指导用户实现 Syncfusion® .NET MAUI 极坐标图（SfPolarChart），以便在极坐标中可视化数据，并在圆形布局中表示数值和角度。这类图表也称为雷达图、蜘蛛网图、网状图、星形图或蛛网图，非常适合以径向方式比较多个数据系列，以及显示周期性或方向性数据模式。

何时使用此技能

当用户需要以下功能时，请使用此技能：

• 创建极坐标图或雷达图 - 在圆形／角度布局中可视化数据
• 以径向方式比较多个数据系列 - 同时以极坐标格式显示 2-3 个或更多系列
• 显示周期性或方向性数据 - 罗盘方向、季节性模式、跨类别的性能指标
• 切换极坐标图和雷达图样式 - 圆形网格线（极坐标图）与多边形网格线（雷达图／蜘蛛网图）
• 实现折线或面积系列 - PolarLineSeries 或 PolarAreaSeries
• 自定义极坐标图外观 - 坐标轴、标记、数据标签、图例、工具提示、颜色
• 配置极坐标角度 - 调整起始角度以适应不同方向（0°、90°、180°、270°）
• 导出极坐标图 - 将图表保存为图像，用于报告或文档

组件概述

主要功能：

• 系列类型：支持多个系列的极坐标折线系列和极坐标面积系列
• 网格线类型：圆形（极坐标图）或多边形（雷达图／蜘蛛网图）
• 坐标轴类型：类别、数值和 DateTime 坐标轴
• 自定义：数据标签、标记、图例、工具提示、颜色、液态玻璃效果
• 渲染位置：可调整极坐标角度以适应不同方向
• 导出：将图表保存为图像格式（PNG、JPEG、BMP）
• 交互性：闭合／开放系列、标记自定义、响应式设计

文档和导航指南

入门

📄 阅读： references/getting-started.md

当用户需要以下功能时：

• 安装并设置 Syncfusion® .NET MAUI Charts 包
• 创建第一个极坐标图
• 了解基本图表结构（SfPolarChart、PrimaryAxis、SecondaryAxis）
• 初始化视图模型和数据绑定
• 向图表添加系列
• 查看完整的可运行示例

系列类型

📄 阅读： references/series-types.md

当用户需要以下功能时：

• 在极坐标折线系列和极坐标面积系列之间进行选择
• 了解 PolarLineSeries 和 PolarAreaSeries 的区别
• 切换网格线类型（Circle 与 Polygon），以呈现极坐标图或雷达图外观
• 配置闭合或开放系列（IsClosed 属性）
• 同时显示多个系列
• 比较系列类型并选择合适的类型

坐标轴配置

📄 阅读： references/axis-configuration.md

当用户需要以下功能时：

• 配置 PrimaryAxis 或 SecondaryAxis
• 使用类别、数值或 DateTime 坐标轴类型
• 自定义坐标轴标签、格式和旋转
• 设置坐标轴线和刻度线样式
• 配置网格线（主网格线和次网格线）
• 设置坐标轴标题和位置
• 调整坐标轴范围和间隔

数据标签和标记

📄 阅读： references/data-labels-markers.md

当用户需要以下功能时：

• 启用并自定义系列数据点上的数据标签
• 设置数据标签的位置和格式
• 创建自定义数据标签模板
• 启用标记（ShowMarkers 属性）
• 自定义标记形状、大小和颜色
• 配置 MarkerSettings 属性

图例和工具提示

📄 阅读： references/legend-tooltip.md

当用户需要以下功能时：

• 添加图例并设置其位置
• 自定义图例项和外观
• 创建自定义图例模板
• 启用交互式工具提示
• 自定义工具提示内容和外观
• 创建自定义工具提示模板

外观自定义

📄 阅读： references/appearance-customization.md

当用户需要：

• 自定义图表颜色和调色板
• 应用特定系列的样式
• 配置背景和边框
• 启用液态玻璃效果，打造现代外观
• 与应用主题集成
• 应用自定义 CSS 或样式模式

渲染位置

📄 阅读： references/rendering-position.md

当用户需要：

• 调整极坐标图表的起始角度
• 旋转图表方向（0°、90°、180°、270°）
• 了解 StartAngle 属性的用法
• 将数据定位到特定的罗盘方向
• 创建角度对齐方式不同的图表

导出

📄 阅读： references/exporting.md

当用户需要：

• 将图表导出为图像格式
• 将图表保存为 PNG、JPEG 或 BMP
• 配置导出设置
• 实现导出功能
• 为报告生成图表图像

无障碍功能

📄 阅读： references/accessibility.md

当用户需要：

• 向屏幕阅读器提供图表标题、图例项和数据点
• 了解播报格式（数据点 =“XValue + YValue + Series Label”）
• 按平台启用无障碍功能（TalkBack、VoiceOver、Narrator）
• 通过键盘浏览图表元素（Windows Narrator、macOS VoiceOver）
• 通过手势浏览图表元素（Android TalkBack、iOS VoiceOver）
• 了解系列兼容性（不支持 PolarAreaSeries）
• 提供有意义的标签，以便进行有效播报