syncfusion-maui-cartesian-charts

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Implementing .NET MAUI Cartesian Charts

实现.NET MAUI笛卡尔图表

Guide users to implement the Syncfusion .NET MAUI Cartesian Chart (SfCartesianChart), a comprehensive data visualization solution with over 20 chart types, interactive features, and extensive customization options. Use this skill to implement charts ranging from simple line graphs to complex financial and statistical visualizations.

本指南指导用户实现Syncfusion .NET MAUI笛卡尔图表（SfCartesianChart），这是一款功能全面的数据可视化解决方案，支持20多种图表类型、交互功能以及丰富的自定义选项。使用此技能可实现从简单折线图到复杂金融和统计可视化的各类图表。

When to Use This Skill

何时使用此技能

Use this skill when the user needs to:

Visualize Data: Display quantitative data with line, area, column, bar, or scatter charts
Financial Analysis: Create candle or OHLC charts for stock price visualization
Statistical Data: Plot box-and-whisker, histogram, or error bar charts
Comparative Analysis: Use stacked charts (area, column, line) for comparing multiple datasets
Range Visualization: Show high-low data with range area or range column charts
Interactive Dashboards: Implement zooming, panning, selection, and trackball features
Time-Series Data: Plot temporal data with datetime axes and auto-scrolling
Custom Visualizations: Add annotations, plotbands, trendlines, and custom styling

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

数据可视化： 使用折线图、面积图、柱状图、条形图或散点图展示量化数据
财务分析： 创建蜡烛图或OHLC图用于股价可视化
统计数据： 绘制箱线图、直方图或误差棒图
对比分析： 使用堆叠图表（面积、柱状、折线）对比多个数据集
范围可视化： 使用范围面积图或范围柱状图展示高低数据
交互式仪表板： 实现缩放、平移、选择和轨迹球功能
时间序列数据： 使用日期时间轴和自动滚动绘制时序数据
自定义可视化： 添加注释、绘图带、趋势线和自定义样式

Component Overview

组件概述

The SfCartesianChart control provides:

20+ Chart Types: Line, Area, Column, Bar, Scatter, Bubble, Candle, OHLC, Histogram, Box-and-Whisker, Stacked variations, Range charts, Waterfall, and more
Flexible Axes: Category, Numerical, DateTime, Logarithmic with full customization
Interactive Features: Zooming, panning, selection, tooltips, trackball, crosshair
Rich Customization: Data labels, legends, annotations, plotbands, trendlines, appearance
Data Handling: Empty point modes, data binding, dynamic updates
Export & Localization: Image export, multi-language support

SfCartesianChart控件提供：

20+种图表类型： 折线图、面积图、柱状图、条形图、散点图、气泡图、蜡烛图、OHLC图、直方图、箱线图、堆叠变体、范围图、瀑布图等
灵活的轴： 类别轴、数值轴、日期时间轴、对数轴，支持完全自定义
交互功能： 缩放、平移、选择、工具提示、轨迹球、十字线
丰富的自定义选项： 数据标签、图例、注释、绘图带、趋势线、外观样式
数据处理： 空点模式、数据绑定、动态更新
导出与本地化： 图片导出、多语言支持

Documentation and Navigation Guide

文档与导航指南

Getting Started

入门指南

📄 Read: references/getting-started.md

NuGet package installation (
```
Syncfusion.Maui.Charts
```
)
Basic SfCartesianChart initialization in XAML and C#
Creating data models and view models
Axis setup (XAxes, YAxes)
Adding your first series with data binding
Complete working example

📄 阅读： references/getting-started.md

NuGet包安装（
```
Syncfusion.Maui.Charts
```
）
在XAML和C#中初始化基础SfCartesianChart
创建数据模型和视图模型
轴设置（XAxes、YAxes）
通过数据绑定添加首个系列
完整的工作示例

Chart Types

图表类型

Basic Chart Types

基础图表类型

📄 Read: references/basic-chart-types.md

Line, Area, Column, Bar, Scatter, Bubble charts
When to use each chart type
Implementation examples
Common properties and styling

📄 阅读： references/basic-chart-types.md

折线图、面积图、柱状图、条形图、散点图、气泡图
每种图表类型的适用场景
实现示例
常用属性和样式设置

Financial Charts

金融图表

📄 Read: references/financial-charts.md

Candle charts (candlestick visualization)
OHLC (Open-High-Low-Close) charts
Financial data structure and binding
Bullish/bearish styling

📄 阅读： references/financial-charts.md

蜡烛图（烛台可视化）
OHLC（开盘-最高-最低-收盘）图
金融数据结构与绑定
看涨/看跌样式设置

Statistical Charts

统计图表

📄 Read: references/statistical-charts.md

Box and Whisker charts
Histogram charts
Error Bar charts
Statistical data requirements

📄 阅读： references/statistical-charts.md

箱线图
直方图
误差棒图
统计数据要求

Stacked Charts

堆叠图表

📄 Read: references/stacked-charts.md

Stacked Area (normal and 100%)
Stacked Column (normal and 100%)
Stacked Line (normal and 100%)
Grouping series for stacking
Percentage vs absolute values

📄 阅读： references/stacked-charts.md

堆叠面积图（常规和100%）
堆叠柱状图（常规和100%）
堆叠折线图（常规和100%）
系列分组以实现堆叠
百分比与绝对值对比

Range Charts

范围图表

📄 Read: references/range-charts.md

Range Area charts
Range Column charts
Spline Range Area charts
High-Low data binding

📄 阅读： references/range-charts.md

范围面积图
范围柱状图
样条范围面积图
高低数据绑定

Advanced Chart Types

高级图表类型

📄 Read: references/advanced-chart-types.md

Fastline (optimized for large datasets)
Step Area and Step Line
Waterfall charts
Performance considerations

📄 阅读： references/advanced-chart-types.md

Fastline（针对大数据集优化）
阶梯面积图和阶梯折线图
瀑布图
性能考量

Axis Configuration

轴配置

Axis Basics

轴基础

📄 Read: references/axis-configuration.md

Axis types (Category, Numerical, DateTime, Logarithmic)
XAxes and YAxes collections
Axis labels and formatting
Axis titles
Multiple axes setup
Custom label customization

📄 阅读： references/axis-configuration.md

轴类型（类别轴、数值轴、日期时间轴、对数轴）
XAxes和YAxes集合
轴标签与格式化
轴标题
多轴设置
自定义标签定制

Axis Customization

轴自定义

📄 Read: references/axis-customization.md

Gridlines (major, minor) styling
Tick lines configuration
Axis padding
Range padding
Auto-scrolling delta
Axis positioning

📄 阅读： references/axis-customization.md

网格线（主网格线、次网格线）样式设置
刻度线配置
轴内边距
范围边距
自动滚动增量
轴定位

Data Visualization & Interaction

数据可视化与交互

Data Labels

数据标签

📄 Read: references/data-labels.md

Enabling and positioning data labels
Label placement (Inner, Outer, Auto)
Label formatting and templates
Styling and appearance
Release mode display configuration

📄 阅读： references/data-labels.md

启用并定位数据标签
标签位置（内部、外部、自动）
标签格式化与模板
样式与外观
Release模式下的显示配置

Tooltips and Interactive Features

工具提示与交互功能

📄 Read: references/tooltips-and-interaction.md

Tooltip configuration and customization
Trackball feature for multi-series comparison
Crosshair for precise value reading
Tooltip templates
Interactive display modes

📄 阅读： references/tooltips-and-interaction.md

工具提示配置与自定义
轨迹球功能用于多系列对比
十字线用于精确读取数值
工具提示模板
交互显示模式

Zooming and Panning

缩放与平移

📄 Read: references/zooming-and-panning.md

Zoom modes (Pinch, Selection, MouseWheel)
Panning configuration
ZoomPanBehavior setup
Programmatic zoom control
Reset zoom functionality

📄 阅读： references/zooming-and-panning.md

缩放模式（捏合、选择、鼠标滚轮）
平移配置
ZoomPanBehavior设置
程序化缩放控制
重置缩放功能

Selection

选择功能

📄 Read: references/selection.md

Selection types (Single, Multiple, Series)
DataPointSelectionBehavior
SeriesSelectionBehavior
Selection events
Custom selection styling

📄 阅读： references/selection.md

选择类型（单个、多个、系列）
DataPointSelectionBehavior
SeriesSelectionBehavior
选择事件
自定义选择样式

Customization & Styling

自定义与样式设置

Legend and Appearance

图例与外观

📄 Read: references/legend-and-appearance.md

Legend configuration and positioning
Legend item templates
Chart appearance customization
Color palettes
Themes and liquid glass effect

📄 阅读： references/legend-and-appearance.md

图例配置与定位
图例项模板
图表外观自定义
调色板
主题与液态玻璃效果

Annotations and PlotBands

注释与绘图带

📄 Read: references/annotations-and-plotbands.md

Annotation types (Text, View, Shape)
Adding and positioning annotations
PlotBand configuration for highlighting regions
Use cases and examples

📄 阅读： references/annotations-and-plotbands.md

注释类型（文本、视图、形状）
添加并定位注释
PlotBand配置用于高亮区域
使用场景与示例

Custom Styling

自定义样式

📄 Read: references/customization-and-styling.md

Series appearance customization
Adding custom labels
Color and gradient fills
Border and corner radius
Template customization

📄 阅读： references/customization-and-styling.md

系列外观自定义
添加自定义标签
颜色与渐变填充
边框与圆角半径
模板自定义

Data Handling & Advanced Features

数据处理与高级功能

Trendlines

趋势线

📄 Read: references/trendlines.md

Trendline types (Linear, Exponential, Logarithmic, Polynomial, Power, Moving Average)
Adding trendlines to series
Forecast and backcast
Trendline customization

📄 阅读： references/trendlines.md

趋势线类型（线性、指数、对数、多项式、幂函数、移动平均）
为系列添加趋势线
预测与回溯预测
趋势线自定义

Data Point Management

数据点管理

📄 Read: references/data-handling.md

Empty points handling
Empty point modes (Gap, Zero, Average, Drop)
Getting data points by region
Touch position detection
Data manipulation

📄 阅读： references/data-handling.md

空点处理
空点模式（间隙、零值、平均值、省略）
通过区域获取数据点
触摸位置检测
数据操作

Export and Localization

导出与本地化

📄 Read: references/exporting-and-localization.md

Exporting charts as images
Export formats and options
Localization configuration
Culture-specific formatting
Resource files

📄 阅读： references/exporting-and-localization.md

将图表导出为图片
导出格式与选项
本地化配置
特定文化的格式化
资源文件